fetch, fournit des builds ES module et CommonJS, et ne comporte aucune dépendance d’exécution. Consultez la vue d’ensemble des SDK serveur pour connaître les éléments communs à tous les SDK.
Installer
@didit-protocol/sdk-node sur npm. Son code source et son journal des modifications se trouvent dans didit-protocol/sdk-node sur GitHub.
Configurer le client
new Didit() lit DIDIT_API_KEY depuis l’environnement sur Node.js, Bun et Deno (avec --allow-env). Les runtimes edge n’ont pas d’environnement de processus, vous devez donc y transmettre la clé en option : new Didit({ apiKey: env.DIDIT_API_KEY }). Transmettez des options pour la remplacer, ou pour définir les identifiants d’organisation et d’application nécessaires aux appels limités à une application (dossiers, réseaux, rapports réglementaires). Le délai d’expiration est exprimé en millisecondes.
const { Didit } = require("@didit-protocol/sdk-node");.
Créer une session
Créez une session de vérification pour un workflow et redirigez votre utilisateur vers son URL. Les champs de la requête conservent les noms définis par l’API.Lire la décision
Lorsque l’utilisateur termine (ou à l’arrivée du webhook), lisez la décision. Chaque résultat de fonctionnalité est une liste contenant une entrée par nœud de workflow, et les dates et heures sont des objetsDate.
Vérifier un webhook
Transmettez le corps brut (pas le JSON analysé) et les en-têtes de la requête : un objetreq.headers Node.js ou Express, un objet Headers Fetch ou des paires [name, value] (le type WebhookHeaders). verify renvoie une promesse et la rejette avec WebhookVerificationError pour tout ce qui n’est pas une livraison valide et récente.
express.raw({ type: "application/json" }) et appelez handleWebhook(req.body, req.headers). Pendant la rotation du secret, transmettez les deux : [newSecret, oldSecret]. Consultez Webhooks pour connaître les événements et le mécanisme de signature.
Analyser une transaction
Soumettez un paiement, un retrait ou un transfert crypto à la surveillance des transactions ; la réponse contient son statut et son score de risque.Vérifier les tokens Authentication
Authentication vérifie les tokens d’accès signés par l’émetteur de votre Authentication, sur votre backend, sans appeler Didit pour chaque requête. Il permet également d’échanger des codes, de rafraîchir des tokens, de vérifier et révoquer des sessions, et d’exécuter des étapes de renforcement de l’authentification.
La vérification de token applique les contrôles décrits dans Vérifier un token sur votre serveur, par rapport à l’émetteur et aux clés de signature de votre application.