Didit integrieren: API, SDK und Webhooks

Vollständiges Transkript von Didit in Ihre App integrieren: API, SDK und Webhooks (Entwicklerleitfaden) - Didit Academy Video 8 von 10, 08:13. Auf YouTube ansehen. Jeder Absatz verlinkt auf den genauen Moment im Video.

​

Was Sie einbinden

00:04 In diesem Video binden Sie Didit in Ihre eigene App ein. Ihre Benutzer verifizieren sich direkt in Ihrem Produkt, und jedes Ergebnis fließt in dem Moment in Ihr System zurück, in dem es eintrifft. Dies ist das Video für Entwickler und deshalb etwas technischer, aber einfacher, als Sie denken. Am Ende sehen Sie, dass Sie den größten Teil davon direkt an Cloud Code übergeben können, damit das Tool es für Sie baut. Wir gehen es also in der Reihenfolge durch, in der

​

SDK, API und Webhook: die drei Bestandteile

00:28 Sie es tatsächlich bauen würden. Legen wir direkt los. Didit einzubinden heißt, drei Dinge zu verbinden. Das SDK stellt die Kamera, die Dokumentenaufnahme, das NFC-Auslesen und die Oberfläche für die Liveness-Erkennung direkt in Ihrer App dar. Die API läuft Server-zu-Server: Ihr Backend erstellt die Sitzung und liest die maßgebliche Entscheidung aus. Und der Webhook ruft Ihren HTTPS-Endpoint in dem Moment auf, in dem sich der Status einer Sitzung ändert. Das ist weit

​

Der Integrate-Tab

00:56 schneller und umfassender als Polling. Der einfachste Weg zur Integration ist, in Ihren Manage-Tab zu gehen, auf Integrate zu klicken und alle Einstellungen von dort zu übernehmen. So können Sie Ihren API-Schlüssel kopieren. Sie können einen eigenen API-Schlüssel für genau die App anlegen, an der Sie gerade arbeiten. Sie können einen Workflow erstellen und auswählen, den Sie integrieren möchten. Sie können einen Webhook hinzufügen. Dorthin werden die Verifizierungsergebnisse übermittelt. 01:24 Und das Signing-Secret, das ich Ihnen gleich zeige, ist das, was

​

Die Auswahl der Plattform

01:28 in Ihre ENV-Datei gelangt. Danach können Sie es mit Ihrer App verbinden. Hier stehen mehrere Optionen zur Verfügung: Web JS, React Native, iOS, Android, Flutter und einige weitere Plattformen. Wählen Sie die aus, die für Ihre App relevant ist. Dies sind die Umgebungs-Secrets, die Sie in Ihrer ENV-Datei auf Ihrem

​

Der KI-Setup-Prompt

01:48 Server ablegen müssen. Der einfache Weg dazu ist der KI-Setup-Prompt. Wir konfigurieren hier oben alle Einstellungen, kopieren dann den Prompt, und er übernimmt alle relevanten Informationen aus dem Setup, das wir hier abgeschlossen haben. Wir kopieren ihn und fügen ihn in Cloud Code, Codex oder wo auch immer Sie

​

API-Schlüssel, einer pro Umgebung

02:09 Ihre App bauen. Ihre API-Schlüssel liegen hier, und jede Zeile enthält einen Schlüssel. Eine gute Gewohnheit ist ein eigener Schlüssel pro Umgebung und pro Integration. So können Sie einen Schlüssel rotieren oder widerrufen, ohne die anderen zu beeinträchtigen. Wenn Sie einen bestimmten Workflow integrieren möchten, sollten Sie

​

Einen Schlüssel erstellen

02:27 vielleicht einen eigenen API-Schlüssel nur für diesen Workflow anlegen. Wenn ich jetzt auf „Create API key“ klicke, nenne ich ihn einfach test und erstelle den Schlüssel. Jetzt kann ich ihn kopieren, richtig? Ich werde ihn nicht noch einmal sehen. Deshalb ist es wichtig, dass Sie ihn kopieren und sich irgendwo notieren, damit Sie ihn bei der Integration verwenden können. Wenn Sie im Integrationsbereich Ihren API-Schlüssel holen, nehmen wir den Test-Schlüssel, scrollen nach unten und wählen diesen KYC-Workflow aus, den wir verwenden wollen. Wir können einen Webhook hinzufügen. 03:05 Wir können unsere App verbinden, okay. Dann können wir hier diesen Setup-Prompt einfügen. Sie sehen hier, dass dieser Prompt

​

Überblick über Webhooks

03:13 den API-Schlüssel enthält. Zu Webhooks, kurz gesagt: Sie können einen Webhook für praktisch alles einrichten. Angenommen, Sie möchten ein bestimmtes Ereignis an Slack senden, richtig? Dann

​

Die Dokumentation

03:25 tragen Sie hier die Webhook-URL ein. Schauen wir uns also einen Teil der Dokumentation an, denn Sie haben Zugriff auf die gesamte technische Dokumentation. Wenn Sie einfach docs.didit.me aufrufen, schauen wir uns hier einige Dinge

​

Create Session: das einzige Pflichtfeld

03:37 an. Alles dreht sich um Create Session. Dies ist eine POST-Anfrage, der Start einer Verifizierung. In der cURL-Anfrage sehen Sie die Workflow-ID. Das ist das einzige Pflichtfeld, und das wirklich Nützliche ist, dass derselbe Endpoint sowohl KYC- als auch KYB-Sitzungen erstellt. Der

​

Vendor-Daten und Callback-URL

04:00 Workflow bestimmt, um welche Art es sich handelt. Weiter unten gibt es einige zusätzliche Felder, darunter die Vendor-Daten, über die wir in diesen Videos schon oft gesprochen haben. Das ist der eindeutige Identifier jedes Benutzers, den Sie frei festlegen können, etwa als E-Mail-Adresse oder eindeutige Kennung. Dann gibt es die Callback-URL. Dorthin wird der Benutzer weitergeleitet, nachdem er den Verifizierungs-Workflow abgeschlossen hat. Also

​

Den Endpoint live ausprobieren

04:24 wenn Sie hier nach unten scrollen, können wir es direkt ausprobieren. Wenn wir auf „Try it“ klicken, können wir hier tatsächlich eine Verifizierungssitzung erstellen. Ich füge einfach einen der API-Schlüssel hier ein, erstelle gerade einen ganz neuen mit dem Namen „test two“. Den kopiere ich und füge ihn hier ein. Wir brauchen eine Workflow-ID, also wechsle ich hierher und kopiere diese Workflow-ID. Sie tragen sie dort ein. Die Vendor-Daten sind nicht erforderlich. Nehmen wir einfach eine zufällige Zahlenfolge. 05:02 Die Callback-URL lassen wir hier so, wie sie ist. Nichts davon ist übrigens Pflicht. Ich glaube, das liegt daran, dass ich hier ein Testkonto habe, aber wenn Sie diesen Endpoint testen möchten, genau so würden Sie es tun. Wenn Sie als Entwickler bestimmte Antworten brauchen, können Sie in der Dokumentation nachsehen. Der MCP hat ebenfalls Zugriff auf die gesamte Dokumentation. Sie können also einfach den MCP einbinden und Claude eine technische Frage stellen, die sehr wahrscheinlich in diesen Dokumenten beantwortet wird.

​

Webhooks: Warum kein Polling

05:32 Hier drin. Sprechen wir also über Webhooks. Im Bereich Verwalten gibt es dafür einen Tab, und darüber erhalten Sie die Ergebnisse tatsächlich. Webhooks sind der empfohlene Kanal, weil Polling ziemlich langsam ist und es

​

Ziel hinzufügen und Ereignisse auswählen

05:44 mehr Anfragen kostet und Ereignisse auslassen kann. Hier fügen wir also ein neues Webhook-Ziel hinzu. Wir können eine URL einfügen und die gewünschten Ereignisse auswählen. Das sind alle Daten, die an diesen bestimmten Endpoint gesendet werden sollen. Didit gibt Ihnen dann ein einmalig angezeigtes Signaturgeheimnis zurück, das ich Ihnen gleich zeige. Die URL muss direkt erreichbar sein, also kein localhost und keine privaten IP-Adressen. Ich verlasse diese Ansicht jetzt und scrolle nach rechts. Dort gibt es einige Optionen. 06:16 Hier sehen wir die Anzahl der Ereignisse, für die dieser Webhook abonniert ist, und wir können

​

Das Signaturgeheimnis

06:19 das Signaturgeheimnis kopieren, das für Ihre Integration wichtig ist. Wenn wir die Einrichtung im Integrations-Tab vornehmen, den ich Ihnen gezeigt habe, gibt es einen Prompt, und dort steht das Signaturgeheimnis für den Webhook, den Sie in der Einrichtung ausgewählt haben. Also

​

Der Prompt für den Webhook-Handler

06:34 gibt es eine weitere Möglichkeit, KI zu nutzen. Hier haben wir einen fertigen Prompt, den ich im Webhooks-Tab gefunden habe. Damit können Sie Ihren Webhook-Handler mithilfe von KI einrichten lassen. Wir können die Dokumentation durchsehen, und dort finden wir einen Integrations-Prompt. Er deckt Identitätsverifizierung, Entitäten und Transaktionen ab und baut alles für Sie aus. Er legt also alles fest: was gebaut werden soll, die Signatur-Header der Verifizierung, die Webhook-Ereignistypen, die Sie vorhin beim Einrichten eines Webhooks gesehen haben, den Webhook-Envelope und noch viel mehr. Außerdem können Sie auswählen, in welches Tool Sie ihn einfügen möchten, also welches Tool Sie gerade verwenden. 07:15 Wenn Sie diesen Prompt nutzen möchten, ist das der einfache Weg, schnell loszulegen und Ihre Integrationen einzurichten. Alles, was ich in diesem Video gerade durchgegangen bin, ist in Ihrem KI-Tool zugänglich und abfragbar, wenn Sie den MCP-Server integrieren. Sie können also einfach in einfachem Englisch beschreiben, was passieren soll, und Cloud Code liest die Dokumentation und baut die Integration für Sie. Sie prüfen dann nur die Arbeit und stellen sicher, dass alles läuft und

​

Zusammenfassung

07:41 funktioniert, statt alles von Grund auf selbst zu programmieren. Das ist Didit in Ihrer App: Das SDK zeigt Ihren Benutzern die Verifizierung, die API wird von Ihrem Backend aufgerufen, und der signierte Webhook liefert das Ergebnis, auf dem Sie aufbauen. Vertrauen Sie dem Webhook, verwenden Sie überall Anbieterdaten und nutzen Sie den Einrichtungs-Prompt, damit Sie die langweiligen Teile nicht von Hand verdrahten müssen. Sie können auf didit.me gehen, sich kostenlos registrieren und in wenigen Minuten eine Verifizierung durchführen.