Zum Hauptinhalt springen
Das offizielle Didit-Gem für Ruby. Es erfordert Ruby 3.1 oder neuer und verwendet net/http aus der Standardbibliothek. Unter Übersicht über die Server-SDKs erfahren Sie, was alle SDKs gemeinsam haben.

Installation

Das Gem ist didit-sdk auf RubyGems. Der Quellcode und das Changelog befinden sich in didit-protocol/sdk-ruby auf GitHub. Oder fügen Sie Ihrem Gemfile gem "didit-sdk" hinzu und führen Sie bundle install aus. Laden Sie es mit require "didit".

Client konfigurieren

Didit::Client.new liest DIDIT_API_KEY aus den Umgebungsvariablen. Übergeben Sie Schlüsselwortargumente, um dies zu überschreiben oder um die Organisations- und Anwendungs-IDs festzulegen, die anwendungsbezogene Aufrufe (Fälle, Netzwerke, regulatorische Berichte) benötigen. Anfragefelder sind Schlüsselwortargumente mit den nativen Namen der API; Antworten sind Objekte mit einem Reader pro Feld, [:field] und to_h.

Sitzung erstellen

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

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.

Webhook verifizieren

Übergeben Sie den Raw-Body genau so, wie er empfangen wurde, sowie die Anfrage-Header. verify löst bei allem, was keine gültige, aktuelle Zustellung ist, einen Didit::WebhookVerificationError aus und gibt andernfalls ein typisiertes Ereignis zurück.
Rufen Sie in Rails handle_webhook(request.raw_post, request.headers) auf. Wenn Sie das Secret rotieren, übergeben Sie beide: [new_secret, old_secret]. Siehe Webhooks für die Ereignisse und das Signaturschema.

Transaktion screenen

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

Authentication-Token verifizieren

Didit::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 Prüfungen aus Token auf Ihrem Server verifizieren anhand des Issuers und der Signaturschlüssel Ihrer Anwendung durch.

Fehler

Listen und Dateien

Die Seiten zu den Server-Endpoints in der API-Referenz enthalten ein Ruby-Beispiel für ihre jeweilige Operation, mit Ausnahme der in der Übersicht genannten Endpoints und Felder, die im Release 1.0.1 noch nicht enthalten sind.
Zuletzt geändert am 7. November 2026