Zum Hauptinhalt springen
Die offizielle Didit-Bibliothek für Node.js und TypeScript. Sie läuft auf Node.js 18 oder höher, Bun, Deno sowie Edge-Runtimes mit 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

Das Paket ist @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.
Unter CommonJS verwenden Sie 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 sind Date-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.
Lesen Sie den Body unter Express mit 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.

Fehler

Listen und Dateien

Die Server-Endpoint-Seiten der API-Referenz enthalten ein Node.js-Beispiel für ihre jeweilige Operation, mit Ausnahme der in der Übersicht genannten Endpoints und Felder, die in keinem 1.0.1-Release enthalten sind.
Zuletzt geändert am 7. November 2026