Passer au contenu principal
POST
curl

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.

Corps

application/json
vendor_data
string
requis

Votre identifiant interne pour l'utilisateur final auquel ce token est limité. Appliqué comme identité du sujet de chaque transaction soumise avec le token.

Exemple:

"user-042"

ttl_seconds
integer
défaut:900

Durée de vie du token en secondes. Vaut par défaut 900 (15 minutes) ; maximum 86400 (24 heures).

Plage requise: x <= 86400
max_uses
integer | null

Nombre maximal de soumissions réussies autorisées avec ce token. Omettre ou définir sur null pour des utilisations illimitées dans la limite du TTL.

Réponse

Le token généré. Transmettez sdk_token à votre application ; il authentifie les endpoints /v1/transactions/ côté appareil via l'en-tête X-Transaction-Token jusqu'à expires_at.

sdk_token
string

Le token de transaction restreint à transmettre au SDK.

expires_at
string<date-time>

Date et heure auxquelles le token cesse d'être accepté.

Dernière modification le 7 novembre 2026