Vai al contenuto principale
La libreria ufficiale di Didit per Python. Richiede Python 3.10 o successivo e offre un client sincrono, Didit, e uno asincrono, AsyncDidit, con gli stessi metodi. Per ciò che tutti gli SDK condividono, consulta la panoramica degli SDK server.

Installazione

Il pacchetto è didit-sdk su PyPI. Il codice sorgente e il registro delle modifiche si trovano in didit-protocol/sdk-python su GitHub. Per verificare i token di Authentication, installa l’extra che aggiunge il controllo della firma:

Configurare il client

Didit() legge DIDIT_API_KEY dall’ambiente. Passa delle opzioni per sovrascriverla, oppure per impostare gli ID dell’organizzazione e dell’applicazione che servono alle chiamate a livello di applicazione (casi, reti, report normativi).

Creare una sessione

Crea una sessione di verifica per un workflow e invia il tuo utente al suo URL.

Leggere la decisione

Quando l’utente termina (o quando arriva il webhook), leggi la decisione. Ogni risultato delle funzionalità è una lista con una voce per ogni nodo del workflow.

Verificare un webhook

Passa i byte esatti del corpo grezzo della richiesta e le intestazioni della richiesta. verify solleva WebhookVerificationError per qualsiasi consegna che non sia valida e recente, quindi è sufficiente intercettare questa sola classe.
In Flask è handle_webhook(request.get_data(), dict(request.headers)); in FastAPI, handle_webhook(await request.body(), request.headers). Mentre ruoti il segreto, passane due: [new_secret, old_secret]. Consulta Webhooks per gli eventi e lo schema di firma.

Sottoporre a screening una transazione

Invia un pagamento, un prelievo o un trasferimento cripto al monitoraggio delle transazioni; la risposta include il suo stato e il punteggio di rischio.

Verificare i token di Authentication

didit.authentication verifica i token di accesso firmati dall’emittente di Authentication, nel tuo backend, senza chiamare Didit per ogni richiesta. Inoltre scambia codici, aggiorna token, verifica e revoca sessioni ed esegue step-up.
La verifica dei token esegue i controlli descritti in Verificare un token sul tuo server, usando l’emittente e le chiavi di firma della tua applicazione.

Errori

Elenchi, file e asincronia

Le pagine degli endpoint server del riferimento API hanno un esempio Python per la rispettiva operazione, tranne per gli endpoint e i campi che nessuna release 1.0.1 include ancora, indicati nella panoramica.
Ultima modifica il 7 novembre 2026