fetch, distribuisce build di moduli ES e CommonJS e non ha dipendenze di runtime. Per ciò che tutti gli SDK server condividono, consulta la panoramica degli SDK server.
Installazione
@didit-protocol/sdk-node su npm. Il codice sorgente e il registro delle modifiche si trovano in didit-protocol/sdk-node su GitHub.
Configurare il client
new Didit() legge DIDIT_API_KEY dalle variabili d’ambiente su Node.js, Bun e Deno (con --allow-env). I runtime edge non hanno un ambiente di processo, quindi lì passa la chiave come opzione: new Didit({ apiKey: env.DIDIT_API_KEY }). Passa delle opzioni per sovrascrivere questo valore, oppure per impostare gli ID di organizzazione e applicazione che le chiamate con ambito applicativo (casi, reti, report normativi) richiedono. Il timeout è espresso in millisecondi.
const { Didit } = require("@didit-protocol/sdk-node");.
Creare una sessione
Crea una sessione di verifica per un workflow e invia il tuo utente al relativo URL. I campi della richiesta mantengono i nomi propri dell’API.Leggere la decisione
Quando l’utente completa il processo (oppure quando arriva il webhook), leggi la decisione. Ogni risultato delle funzionalità è una lista con una voce per ogni nodo del workflow, e le date e gli orari sono oggettiDate.
Verificare un webhook
Passa il corpo grezzo (non il JSON analizzato) e le intestazioni della richiesta: un oggettoreq.headers di Node.js o Express, un oggetto Headers di Fetch oppure coppie [name, value] (il tipo WebhookHeaders). verify restituisce una promise e rifiuta con WebhookVerificationError qualsiasi consegna che non sia valida e recente.
express.raw({ type: "application/json" }) e chiama handleWebhook(req.body, req.headers). Mentre ruoti il segreto, passa entrambi: [newSecret, oldSecret]. Per gli eventi e lo schema di firma, consulta Webhook.
Sottoporre una transazione a screening
Invia un pagamento, un prelievo o un trasferimento di criptovalute al monitoraggio delle transazioni; la risposta riporta il relativo stato e il punteggio di rischio.Verificare i token di Authentication
Authentication verifica i token di accesso firmati dal tuo emittente Authentication, nel tuo backend, senza chiamare Didit per ogni richiesta. Inoltre scambia i codici, rinnova i token, verifica e revoca le sessioni ed esegue i flussi di step-up.
La verifica dei token esegue i controlli descritti in Verifica un token sul tuo server, con l’emittente e le chiavi di firma della tua applicazione.