java.net.http, Jackson sowie den JSpecify-Nullness-Annotationen ab. Jede Methode verfügt über eine ...Async-Variante, die ein CompletableFuture zurückgibt. In der Übersicht über die Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.
Installieren
me.didit:didit-java auf Maven Central. Der Quellcode und das Changelog befinden sich in didit-protocol/sdk-java auf GitHub.
Den Client konfigurieren
new Didit() liest DIDIT_API_KEY aus der Umgebung aus. Verwenden Sie den Builder, um diesen zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die für anwendungsbezogene Aufrufe (Fälle, Netzwerke, aufsichtsrechtliche Berichte) erforderlich sind.
build()-Methode die erforderlichen Felder prüft. Optionale Antwortfelder sind Optional-Werte; in Kotlin lesen Sie diese mit .getOrNull() aus. Die Snippets auf dieser Seite und auf den einzelnen Seiten der API-Referenz stellen den Rumpf einer Methode dar, mit den jeweils benötigten Imports darüber.
Eine Sitzung erstellen
Erstellen Sie eine Verifizierungssitzung für einen Workflow und leiten Sie Ihren Benutzer an deren URL weiter.Die Entscheidung abrufen
Wenn der Benutzer den Vorgang abschließt (oder wenn der Webhook eintrifft), rufen Sie die Entscheidung ab. Jedes Funktionsergebnis ist eine Liste mit einem Eintrag pro Workflow-Knoten.Einen Webhook verifizieren
Übergeben Sie den Roh-Body exakt so, wie er empfangen wurde, sowie die Anfrage-Header.Webhooks.verify wirft eine WebhookVerificationException für alles, was keine gültige, aktuelle Zustellung ist, und gibt andernfalls ein typisiertes Ereignis zurück.
@RequestBody byte[] body und die Header als @RequestHeader Map<String, String> headers entgegen. Um zwei Secrets zu akzeptieren, während Sie eines rotieren, übergeben Sie VerifyOptions. Siehe Webhooks für die Ereignisse und das Signaturschema.
Eine Transaktion screenen
Übermitteln Sie eine Zahlung, eine Auszahlung oder einen Krypto-Transfer an die Transaktionsüberwachung; die Antwort enthält deren Status und den Risiko-Score.Authentication-Token verifizieren
Authentication überprüft die Zugriffstoken, die Ihr Authentication-Issuer signiert, in Ihrem Backend, ohne Didit bei jeder Anfrage aufzurufen. Es tauscht außerdem Codes aus, aktualisiert Token, prüft und widerruft Sitzungen und führt Step-ups durch.
Die Token-Verifizierung führt die in Token auf Ihrem Server verifizieren beschriebenen Prüfungen anhand des Issuers und der Signaturschlüssel Ihrer Anwendung durch.
Fehler
Jede Exception erbt von der ungeprüftenDiditException.