Saltar al contingut principal
La biblioteca oficial de Didit per a Node.js i TypeScript. Funciona amb Node.js 18 o posterior, Bun, Deno i entorns d’execució edge amb fetch, inclou compilacions per a mòduls ES i CommonJS, i no té dependències en temps d’execució. Consulta la visió general dels SDK de servidor per saber què comparteixen tots els SDK.

Instal·lació

El paquet és @didit-protocol/sdk-node a npm. El codi font i el registre de canvis són a didit-protocol/sdk-node a GitHub.

Configura el client

new Didit() llegeix DIDIT_API_KEY de l’entorn a Node.js, Bun i Deno (amb --allow-env). Els entorns d’execució edge no tenen entorn de procés, així que hi has de passar la clau d’API com a opció: new Didit({ apiKey: env.DIDIT_API_KEY }). Passa opcions per sobreescriure-la, o per definir els identificadors de l’organització i de l’aplicació que necessiten les crides amb abast d’aplicació (casos, xarxes, informes regulatoris). El temps màxim d’espera s’indica en mil·lisegons.
Amb CommonJS, fes servir const { Didit } = require("@didit-protocol/sdk-node");.

Crea una sessió

Crea una sessió de verificació per a un flux de treball i envia el teu usuari a la seva URL. Els camps de la sol·licitud mantenen els noms de l’API.

Llegeix la decisió

Quan l’usuari acaba (o quan arriba el webhook), llegeix la decisió. El resultat de cada funcionalitat és una llista amb una entrada per cada node del flux de treball, i les dates i hores són objectes Date.

Verifica un webhook

Passa el cos sense processar (no el JSON analitzat) i les capçaleres de la petició: un objecte req.headers de Node.js o Express, un objecte Headers de Fetch o parells [name, value] (el tipus WebhookHeaders). verify retorna una promesa i rebutja amb WebhookVerificationError qualsevol cosa que no sigui un lliurament vàlid i recent.
Amb Express, llegeix el cos amb express.raw({ type: "application/json" }) i crida handleWebhook(req.body, req.headers). Mentre canvies el secret, passa’ls tots dos: [newSecret, oldSecret]. Consulta Webhooks per als esdeveniments i l’esquema de signatura.

Cribra una transacció

Envia un pagament, una retirada o una transferència de criptomonedes al monitoratge de transaccions; la resposta conté el seu estat i la puntuació de risc.

Verifica els tokens d’Authentication

Authentication verifica els tokens d’accés que signa el teu emissor de Authentication, al teu backend, sense cridar Didit per a cada petició. També intercanvia codis, renova tokens, comprova i revoca sessions, i executa passos d’autenticació reforçada.
La verificació de tokens fa les comprovacions de Verifica un token al teu servidor, contra l’emissor i les claus de signatura de la teva aplicació.

Errors

Llistes i fitxers

Les pàgines d’endpoints de servidor de la referència de l’API tenen un exemple en Node.js per a la seva operació, excepte els endpoints i camps que encara no estan disponibles en cap versió 1.0.1, indicats a la visió general.
Darrera modificació el 7 de novembre del 2026