Passer au contenu principal
POST
Python

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Paramètres de chemin

sessionId
string<uuid>
requis

UUID de la session de Vérification d'entreprise (KYB). Il doit appartenir à l'application de la clé API.

Exemple:

"33333333-4444-5555-6666-777777777777"

Paramètres de requête

node_id
string

Nœud de workflow de l'étape KYB. Nécessaire uniquement lorsque le workflow comporte plus d'un nœud KYB ; par défaut, Didit utilise le nœud propre à la session.

Corps

application/json
locale
string

Locale utilisée pour traduire la réponse de l'étape vers laquelle la session avance.

Maximum string length: 10

Réponse

Parties déclarées (ou déjà déclarées).

valid
boolean
next_step
string | null

Étape où se trouve la session.

status
string

Statut de la session d'entreprise.

advanced
boolean

true lorsque cet appel a déclaré les parties et fait avancer la session.

already_submitted
boolean

true lorsque les parties avaient été déclarées par un appel antérieur.

kyb_key_people_status
string
parties
object[]
Dernière modification le 7 novembre 2026