Passer au contenu principal
POST
cURL
Utilisez cet endpoint lorsque vous devez séparer le trafic de vérification, les identifiants, l’image de marque ou les rapports au sein de la même organisation. Cela est particulièrement utile pour les revendeurs qui créent une application par client. Cela convient également lorsque votre entreprise dispose de plusieurs produits, marques, régions, environnements de préproduction et de production, ou cas d’usage qui ne doivent pas partager la même clé API ni les mêmes paramètres au niveau de l’application.
Tous les endpoints de l’Auth API utilisent https://apx.didit.me/auth/v2. Utilisez la valeur api_key renvoyée comme x-api-key lors de l’appel aux endpoints https://verification.didit.me/v3/..., tels que les sessions et les workflows.

Localisation des données

Chaque application stocke et traite ses données de vérification à un emplacement unique, appelé sa localisation des données, choisi lors de sa création avec data_location. Aujourd’hui, la seule localisation disponible est eu, l’Union européenne (Irlande), qui est aussi la valeur par défaut si vous omettez ce champ. L’Australie (Sydney, au) et le Mexique (mx) sont bientôt disponibles : une requête qui les mentionne reçoit une réponse 400 This data location is not available yet. et ne crée rien. Chaque lecture de l’application renvoie sa data_location, qui ne peut pas être modifiée une fois l’application créée. Voir Localisation des données.

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. Obtenez-le avec GET /organizations/me/.

Exemple:

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

Corps

application/json

Tous les champs sont facultatifs. Omettre le corps crée une application avec le nom par défaut "<organization name> App" et aucune URL publique configurée.

Tous les champs sont facultatifs. Envoyer un corps vide crée une application avec un nom par défaut, dans l'Union européenne.

name
string

Nom d'affichage de l'application. Vaut par défaut "<organization name> App".

Exemple:

"Acme Customer App"

website_url
string

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

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

Exemple:

"https://acme.example/terms"

privacy_url
string

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

Exemple:

"https://acme.example/privacy"

description
string

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

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"

Réponse

Application créée. La réponse inclut la api_key de longue durée ; conservez-la dès maintenant et utilisez-la comme en-tête x-api-key sur chaque appel https://verification.didit.me/v3/....

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