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

multipart/form-data
documents
file[]
requis

Fichiers à téléverser : JPG, JPEG, PNG, TIFF, WEBP, PDF ou archives ZIP de ceux-ci. PDF jusqu'à 50 MB, photos jusqu'à 6 MB avant compression.

document_passwords
string[]

Une entrée par fichier dans documents, dans le même ordre : le mot de passe d'un PDF protégé, vide pour tout autre fichier.

document_group
enum<string>

Groupe de documents requis auquel correspond ce téléversement.

Options disponibles:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Locale utilisée pour traduire la réponse de l'étape suivante.

Maximum string length: 10

Réponse

Documents traités. Lorsque chaque groupe requis est satisfait, la session avance et next_step indique l'étape suivante ; sinon, elle reste à l'étape Documents et document_groups ainsi que document_answer indiquent ce qui manque encore.

valid
boolean
next_step
string | null

Étape où se trouve la session après le téléversement.

kyb_status
string

Statut de la vérification de l'entreprise.

document_answer
object

Résultat pour chaque document téléversé et nombre de téléversements restants.

Dernière modification le 7 novembre 2026