Zum Hauptinhalt springen
Die offizielle Didit-Bibliothek für Python. Sie erfordert Python 3.10 oder neuer und bietet einen synchronen Client, Didit, sowie einen asynchronen Client, AsyncDidit, mit denselben Methoden. In der Übersicht der Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.

Installation

Das Paket heißt didit-sdk und ist auf PyPI verfügbar. Quellcode und Changelog finden Sie unter didit-protocol/sdk-python auf GitHub. Um Authentication-Tokens zu verifizieren, installieren Sie das Extra für die Signaturprüfung:

Den Client konfigurieren

Didit() liest DIDIT_API_KEY aus der Umgebung aus. Übergeben Sie Optionen, um dies zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die Aufrufe auf Anwendungsebene (Fälle, Netzwerke, aufsichtsrechtliche Berichte) benötigen.

Eine Sitzung erstellen

Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer zu deren URL weiter.

Die Entscheidung abrufen

Sobald der Benutzer den Vorgang abschließt (oder wenn der Webhook eingeht), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag pro Workflow-Knoten.

Einen Webhook verifizieren

Übergeben Sie die exakten Bytes des rohen Anfrage-Bodys und die Anfrage-Header. verify löst für alles, was keine gültige, aktuelle Zustellung ist, einen WebhookVerificationError aus, sodass das Abfangen dieser einen Klasse ausreicht.
In Flask lautet dies handle_webhook(request.get_data(), dict(request.headers)); in FastAPI handle_webhook(await request.body(), request.headers). Während Sie das gemeinsame Geheimnis rotieren, übergeben Sie beide: [new_secret, old_secret]. Unter Webhooks finden Sie die Ereignisse und das Signaturschema.

Eine Transaktion screenen

Übermitteln Sie eine Zahlung, Auszahlung oder einen Krypto-Transfer an die Transaktionsüberwachung; die Antwort enthält ihren Status und Risiko-Score.

Authentication-Tokens verifizieren

didit.authentication prüft die von Ihrem Authentication-Issuer signierten Access-Tokens direkt 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 zusätzliche Authentifizierungsschritte durch.
Die Token-Verifizierung führt die unter Ein Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Ausstellers und der Signaturschlüssel Ihrer Anwendung durch.

Fehler

Listen, Dateien und asynchrone Verarbeitung

Die Seiten der Server-Endpoints in der API-Referenz enthalten ein Python-Beispiel für ihre jeweilige Operation, ausgenommen jene Endpoints und Felder, die in keinem 1.0.1-Release enthalten sind und in der Übersicht genannt werden.
Zuletzt geändert am 7. November 2026