Passer au contenu principal
GET
cURL

Autorisations

Authorization
string
header
requis

JWT access_token signé en RS256 renvoyé par POST /programmatic/login/ ou POST /programmatic/verify-email/. À envoyer sous la forme Authorization: Bearer <access_token>. La durée de vie par défaut est de 86400 secondes (24h). Ce token n'est valable que pour les endpoints de gestion de compte sur apx.didit.me/auth/v2. L'API de vérification (verification.didit.me/v3) utilise plutôt la api_key de longue durée sous forme de x-api-key.

Paramètres de chemin

org_id
string<uuid>
requis

UUID de l'organisation propriétaire de l'application.

Exemple:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
requis

UUID de l'application dont vous souhaitez lire les identifiants.

Exemple:

"b2c3d4e5-6789-01bc-defg-222222222222"

Réponse

Enregistrement de l'application incluant son client_id et son api_key.

Enregistrement complet de l'application. uuid, client_id et api_key ne changent jamais après la création. data_location non plus, sauf une fois sur l'application de production créée avec votre organisation, avant sa première utilisation (voir la requête de mise à jour).

uuid
string<uuid>

UUID de l'application. À utiliser comme {app_id} dans les appels ultérieurs.

Exemple:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Nom d'affichage de l'application affiché dans la console Didit.

Exemple:

"Acme Production App"

client_id
string

Identifiant client public, pouvant être intégré en toute sécurité dans des flux de type OAuth.

Exemple:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

Secret à longue durée de vie (également appelé client_secret). À utiliser comme en-tête x-api-key pour chaque appel à https://verification.didit.me/v3/... (sessions, workflows, AML, etc.). Traitez-le comme un identifiant confidentiel ; ne l'exposez jamais côté client. Les nouvelles clés commencent par sk_live_ (application de production) ou sk_test_ (application sandbox), suivies de 43 caractères compatibles avec les URL (lettres, chiffres, - et _). Les clés créées avant ce format n'ont aucun préfixe et continuent de fonctionner à l'identique. Pendant 72 heures après la récupération de votre compte, lister, récupérer et mettre à jour renvoient une chaîne vide ici à la place de la clé.

Exemple:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

URL du site web ou de l'application associée à cette application.

Exemple:

"https://acme.example"

redirect_uris
string[]

URI de redirection autorisées pour les flux de redirection de type OAuth et de vérification.

Exemple:
terms_url
string | null

URL des conditions d'utilisation affichée dans le flux de vérification.

Exemple:

"https://acme.example/terms"

privacy_url
string | null

URL de la politique de confidentialité affichée dans le flux de vérification.

Exemple:

"https://acme.example/privacy"

description
string | null

Description interne de l'application (non visible par les utilisateurs finaux).

created_at
string<date-time>
Exemple:

"2025-06-01T10:00:00Z"

data_location
enum<string>

Emplacement où les données de vérification de l'application sont stockées et traitées, choisi lors de la création de l'application. eu correspond à l'Union européenne (Irlande), la valeur par défaut. au (Australie, Sydney) et mx (Mexique) seront bientôt disponibles : une requête les mentionnant renvoie une erreur 400 This data location is not available yet. L'application Sandbox d'une organisation se trouve toujours dans l'Union européenne.

Options disponibles:
eu,
au,
mx
Exemple:

"eu"

products
object[]
read-only

Les produits de l'application. Toujours les trois, dans cet ordre : identity, transactions, authentication. Une nouvelle application a identity activé avec chaque module activé, et transactions ainsi que authentication désactivés. Lecture seule : une clé products dans un corps de création ou de mise à jour est ignorée.

Exemple:
Dernière modification le 7 novembre 2026