Passer au contenu principal
PATCH
cURL
Utilisez cet endpoint pour que chaque application reste alignée sur le client, la marque, l’environnement ou le cas d’usage interne qu’elle représente. Pour les revendeurs, cela vous permet de renommer ou de mettre à jour chaque application client sans partager les identifiants entre les clients. Pour les clients directs, cela permet de séparer les produits, les régions ou les environnements tout en gardant l’ensemble sous une même organisation.
Cet endpoint met à jour les métadonnées de l’application. La valeur api_key reste la même, sauf si vous renouvelez les identifiants séparément.

Emplacement des données

L’emplacement des données de l’application (data_location) est choisi à la création de l’application et ne peut plus être modifié ensuite : une mise à jour qui indique l’emplacement déjà attribué à l’application est acceptée, et toute autre valeur renvoie 400. Il existe une exception pour l’application de production créée avec votre organisation, lors de l’inscription ou via Vérifier l’e-mail. La première mise à jour qui indique un data_location fixe son emplacement, une seule fois, à condition qu’aucune des clés API de l’application n’ait été utilisée et qu’elle n’ait aucune session de vérification. L’étape Nommez votre première application de la console utilise ce mécanisme pour enregistrer l’emplacement que vous choisissez à cette étape. Aujourd’hui, le seul emplacement disponible est eu, l’Union européenne (Irlande).

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 à mettre à jour.

Exemple:

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

Corps

application/json

Envoyez uniquement les champs que vous souhaitez modifier. Sémantique PATCH : les champs manquants sont conservés.

Corps PATCH pour les métadonnées de l'application. N'envoyez que les champs que vous souhaitez modifier ; les champs omis sont conservés. uuid, client_id et api_key ne peuvent pas être mis à jour. products est en lecture seule : une clé products dans le corps est ignorée. data_location ne peut pas être modifié après la création de l'application : indiquer l'emplacement qu'elle a déjà est accepté, et tout autre emplacement renvoie 400. La seule exception concerne l'application de production créée avec votre organisation : la première mise à jour qui indique une data_location la choisit, une seule fois, tant qu'aucune clé API de l'application n'a été utilisée et qu'elle n'a aucune session de vérification.

name
string

Nom d'affichage de l'application.

Exemple:

"Acme Production App"

website_url
string

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

Exemple:

"https://app.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.

privacy_url
string

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

description
string

Description interne de l'application.

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 mise à jour. La réponse est l'enregistrement complet de l'application après la modification, y compris products ; uuid, client_id et api_key sont inchangés.

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