fetch, incluye versiones para módulos ES y CommonJS, y no tiene dependencias en tiempo de ejecución. Consulta la visión general de los SDK de servidor para ver lo que comparten todos los SDK.
Instalación
@didit-protocol/sdk-node en npm. Su código fuente y su registro de cambios están en didit-protocol/sdk-node en GitHub.
Configurar el cliente
new Didit() lee DIDIT_API_KEY del entorno en Node.js, Bun y Deno (con --allow-env). Los entornos de ejecución edge no tienen entorno de proceso, así que ahí pasa la clave como opción: new Didit({ apiKey: env.DIDIT_API_KEY }). Pasa opciones para sobrescribirla o para definir los ID de organización y de aplicación que necesitan las llamadas con ámbito de aplicación (casos, redes, informes regulatorios). El tiempo de espera se indica en milisegundos.
const { Didit } = require("@didit-protocol/sdk-node");.
Crear una sesión
Crea una sesión de verificación para un workflow y envía a tu usuario a su URL. Los campos de la solicitud conservan los nombres propios de la API.Leer la decisión
Cuando el usuario termine (o cuando llegue el webhook), lee la decisión. Cada resultado de función es una lista con una entrada por cada nodo del flujo, y las fechas y horas son objetosDate.
Verificar un webhook
Pasa el cuerpo sin procesar (no el JSON ya parseado) y los encabezados de la solicitud: un objetoreq.headers de Node.js o Express, un objeto Headers de Fetch o pares [name, value] (el tipo WebhookHeaders). verify devuelve una promesa que se rechaza con WebhookVerificationError ante cualquier cosa que no sea una entrega válida y reciente.
express.raw({ type: "application/json" }) y llama a handleWebhook(req.body, req.headers). Mientras rotas el secreto, pasa ambos: [newSecret, oldSecret]. Consulta Webhooks para conocer los eventos y el esquema de firma.
Analizar una transacción
Envía un pago, un retiro o una transferencia de criptomonedas a la monitorización de transacciones; la respuesta incluye su estado y su puntuación de riesgo.Verificar tokens de Authentication
Authentication comprueba los tokens de acceso que firma tu emisor de Authentication, en tu backend, sin realizar una solicitud a Didit en cada solicitud. También intercambia códigos, renueva tokens, comprueba y revoca sesiones, y ejecuta verificaciones adicionales (step-ups).
La verificación de tokens realiza las comprobaciones descritas en Verificar un token en tu servidor, contra el emisor y las claves de firma de tu aplicación.