Saltar al contingut principal
POST
curl

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Cos

application/json
vendor_data
string
requerit

El teu identificador intern per a l'usuari final a qui s'aplica aquest token. S'aplica com la identitat del subjecte de cada transacció enviada amb el token.

Exemple:

"user-042"

ttl_seconds
integer
predeterminat:900

Temps de vida del token en segons. Per defecte és 900 (15 minuts); màxim 86400 (24 hores).

Rang requerit: x <= 86400
max_uses
integer | null

Nombre màxim d'enviaments satisfactoris permesos amb aquest token. Omet o defineix com a null per a usos il·limitats dins del TTL.

Resposta

El token emès. Lliura sdk_token a la teva aplicació; autentica els endpoints de /v1/transactions/ orientats al dispositiu mitjançant la capçalera X-Transaction-Token fins a expires_at.

sdk_token
string

El token de transacció amb abast que s'ha de passar a l'SDK.

expires_at
string<date-time>

Quan el token deixa de ser acceptat.

Darrera modificació el 7 de novembre del 2026