Vai al contenuto principale
POST
curl

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Corpo

application/json
vendor_data
string
obbligatorio

Il tuo identificatore interno per l'utente finale a cui è limitato questo token. Imposto come identità del soggetto di ogni transazione inviata con il token.

Esempio:

"user-042"

ttl_seconds
integer
predefinito:900

Durata del token in secondi. Il valore predefinito è 900 (15 minuti); massimo 86400 (24 ore).

Intervallo richiesto: x <= 86400
max_uses
integer | null

Numero massimo di invii riusciti consentiti con questo token. Omettere o impostare su null per utilizzi illimitati entro il TTL.

Risposta

Il token emesso. Passa sdk_token alla tua app; autentica gli endpoint /v1/transactions/ rivolti al dispositivo tramite l'intestazione X-Transaction-Token fino a expires_at.

sdk_token
string

Il token di transazione con ambito da passare all'SDK.

expires_at
string<date-time>

Quando il token smette di essere accettato.

Ultima modifica il 7 novembre 2026