fetch, stellt ES-Modul- und CommonJS-Builds bereit und hat keine Laufzeitabhängigkeiten. In der Übersicht über die Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.
Installieren
@didit-protocol/sdk-node auf npm. Der Quellcode und das Changelog befinden sich unter didit-protocol/sdk-node auf GitHub.
Client konfigurieren
new Didit() liest DIDIT_API_KEY unter Node.js, Bun und Deno (mit --allow-env) aus der Umgebung aus. Da Edge-Runtimes keine Prozessumgebung besitzen, übergeben Sie den Schlüssel dort als Option: new Didit({ apiKey: env.DIDIT_API_KEY }). Übergeben Sie Optionen, um ihn zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die Aufrufe auf Anwendungsebene (Fälle, Netzwerke, behördliche Berichte) benötigen. Das Timeout wird in Millisekunden angegeben.
const { Didit } = require("@didit-protocol/sdk-node");.
Sitzung erstellen
Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer zu dessen URL weiter. Anfragefelder behalten die Namen der API bei.Entscheidung abrufen
Sobald der Benutzer fertig ist (oder wenn der Webhook eintrifft), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag pro Workflow-Knoten, und Datums- und Zeitangaben sindDate-Objekte.
Webhook verifizieren
Übergeben Sie den rohen Body (kein geparstes JSON) und die Anfrage-Header: ein Node.js- oder Express-req.headers-Objekt, ein Fetch-Headers-Objekt oder [name, value]-Paare (der Typ WebhookHeaders). verify gibt ein Promise zurück und schlägt mit WebhookVerificationError für alles fehl, was keine gültige, aktuelle Zustellung ist.
express.raw({ type: "application/json" }) aus und rufen Sie handleWebhook(req.body, req.headers) auf. Wenn Sie das Secret rotieren, übergeben Sie beide: [newSecret, oldSecret]. Unter Webhooks finden Sie die Ereignisse und das Signaturschema.
Transaktion prüfen
Übermitteln Sie eine Zahlung, eine Auszahlung oder einen Krypto-Transfer an die Transaktionsüberwachung; die Antwort enthält den Status und den Risiko-Score.Authentication-Tokens verifizieren
Authentication prüft die Zugriffstoken, die Ihr Authentication-Aussteller signiert, in Ihrem Backend, ohne Didit bei jeder Anfrage aufzurufen. Es tauscht außerdem Codes aus, aktualisiert Tokens, prüft und widerruft Sitzungen und führt Step-up-Authentifizierungen durch.
Die Token-Prüfung führt die unter Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Ausstellers und der Signaturschlüssel Ihrer Anwendung durch.