Entwickler
Integration mit klarem Umfang beginnen.
Prüfen Sie API-Struktur, erforderliche Datenfelder und Antworten. Definieren Sie den passenden Kontrollablauf für Ihr Produkt.
{
"product": "aml",
"name": "Example Customer",
"retention_years": 0
}
{
"id": "tr_example_result",
"persona_id": "tr_example_persona",
"onboarding_id": "tr_example_session",
"product": "aml",
"status": "pending",
"session_token": "SCOPED_SESSION_TOKEN"
}
{
"error": {
"code": "validation_error",
"message": "Request validation failed",
"details": {}
}
}
OpenAPI 3.1 · V3
Konkrete API-Verträge für Ihre V3-Integration.
Laden Sie separate OpenAPI-3.1-Dateien für die regionale API, zugewiesene Rechenressourcen und den Medienzugriff herunter. Nutzen Sie Anfragen, Antworten, Berechtigungen und Fehlerformate für Ihre Integration.
- Regionale API · OpenAPI JSON
- Compute-Dienst · OpenAPI JSON
- Mediendienst · OpenAPI JSON
- Integrationsleitfaden · englisches Markdown
Authentifizierung auf Ihrem Backend
Der an den Workspace gebundene Bearer-API-Schlüssel bleibt auf Ihrem Backend. Panel-Sitzungen wählen den Workspace mit X-Workspace-ID. Senden Sie den Schlüssel niemals an Apps, Browser oder Compute-Hosts.
Persona und neue Sitzung
Ordnen Sie Ihre stabile Kundenreferenz mit POST /v3/personas zu und erstellen Sie die ausgewählten Leistungen mit POST /v3/onboardings. Das Gerät erhält nur den sitzungsgebundenen session_token und vertrauenswürdige Verbindungsdaten. Ein neues Onboarding ist ein neuer Versuch; leere Sitzungen und Wartezeiten sind kostenfrei.
Direkt zum zugewiesenen Compute hochladen
Nehmen Sie ein Warteschlangenangebot mit claim an, um compute_url und compute_token zu erhalten. Laden Sie Rohdaten direkt dorthin hoch, ohne Multipart. KI-Aufnahmen senden neue Fragmente desselben Recorders. LiveKit wird nur für manuelle Videoanrufe verwendet.
Warteschlange und asynchrone Ergebnisse
Verfolgen Sie die Warteschlange über den Status-Endpunkt oder authentifiziertes SSE. Eine 202-Produktantwort bedeutet zur Verarbeitung angenommen, nicht genehmigt. Lesen Sie den Endstatus aus der regionalen API. Prüfen Sie Webhook-Signaturen über Rohdaten und deduplizieren Sie Ereignis-IDs; die Reihenfolge kann abweichen.
Wiederholungen, Seitennavigation und Fehler
Wiederholen Sie dieselbe Änderung mit identischem Inhalt und Idempotency-Key. Übergeben Sie next_cursor als after für die nächste Seite. Reagieren Sie auf error.code; aktualisieren Sie bei 409 den Status und beachten Sie Retry-After bei 429/503. Kapazitäts- oder technische Fehler sind keine Identitätsablehnung.
SDK-Bereitstellung und Versionsumfang
Der V3-Integrationskandidat dev.2 umfasst Node-, Python-, .NET- und Java-Pakete sowie ein Go-Quellarchiv. Es gibt keine öffentliche Registry-Veröffentlichung. Klären Sie Paketbereitstellung, Manifestprüfung und Plattformabnahme mit unserem Team. OpenAPI-Dateien sind keine Bereitstellungs- oder Kapazitätszusage.
Synthetisches V3-Beispiel; keine Live-Anfrage.
Erste Schritte
Erste Integrationsschritte.
Definieren Sie in vier Schritten den Umfang, richten Sie sicheren Zugriff ein und implementieren Sie neben der erfolgreichen Antwort auch Prüf- und Fehlerzustände.
- 01Produkt wählen.
Benötigte Kontrolle und deren Umfang festlegen.
- 02Authentifizierung einrichten.
API-Zugangsdaten nur in einer sicheren Serverumgebung verwenden.
- 03Beispielanfrage ausführen.
Nutzungsbedingungen der Testumgebung beachten.
- 04Fehler- und Prüfzustände implementieren.
Nicht nur die erfolgreiche Antwort gestalten.
Analyse von Transaktionsverbindungen
Netzwerk und Tiefe für die Wallet-Prüfung wählen.
Lesen Sie zuerst die aktivierten Netzwerke aus der regionalen wallet-capabilities-Antwort. Senden Sie dann eine ausdrückliche chain und wallet_depth: 0 nur für den Adresslistenabgleich, 1 für direkte Gegenparteien, 2 für direkte und indirekte Gegenparteien. Standardtiefe ist 2; Asset-Kürzel wie USDT ersetzen keine Netzwerkauswahl.
- Asynchrone Ergebnisse mit ihrem Umfang lesenRufen Sie GET /v3/products/{id} mit der bei der Erstellung erhaltenen id ab. potential_match ist ein zu prüfender Listenbefund. no_match bedeutet keinen Treffer innerhalb der vollständig geprüften Abdeckung. inconclusive bedeutet unvollständige Prüfung, keine automatische Freigabe. Bewahren Sie trace.complete, reasons, coverage, limitations und snapshot auf.
Ungültige Netzwerke oder Adressen sowie inaktive regionale Anbieter werden vor der Kreditbelastung abgelehnt. API-Zugangsdaten bleiben serverseitig. Die folgende Adresse dient nur als Syntaxbeispiel; das Beispiel sendet keine Netzwerkanfrage.
{
"product": "wallet_screening",
"address": "0x1111111111111111111111111111111111111111",
"chain": "ETH",
"wallet_depth": 2,
"retention_years": 0
}
GET /v3/products/wallet-capabilities
GET /v3/products/{id}
Ressourcen
Ressourcen.
-
Interaktiver IntegrationsleitfadenInteraktiver Integrationsleitfaden
Wählen Sie Prüfungen und Codesprache und erstellen Sie einen Schritt-für-Schritt-Leitfaden für Sitzungen, direkte Uploads und Ergebnisse.
-
Regionale API · OpenAPI JSONV3-API-Referenz öffnen
Laden Sie separate OpenAPI-3.1-Dateien für die regionale API, zugewiesene Rechenressourcen und den Medienzugriff herunter. Nutzen Sie Anfragen, Antworten, Berechtigungen und Fehlerformate für Ihre Integration.
-
Integrationsleitfaden · englisches MarkdownLeitfaden herunterladen
Laden Sie den englischen technischen Leitfaden zu Authentifizierung, Sitzungen und Medien, Webhook-Prüfung und Installation der dev.2-Pakete herunter.
-
SDK-Bereitstellung und VersionsumfangV3-SDK-Integration besprechen
Der V3-Integrationskandidat dev.2 umfasst Node-, Python-, .NET- und Java-Pakete sowie ein Go-Quellarchiv. Es gibt keine öffentliche Registry-Veröffentlichung. Klären Sie Paketbereitstellung, Manifestprüfung und Plattformabnahme mit unserem Team. OpenAPI-Dateien sind keine Bereitstellungs- oder Kapazitätszusage.
-
SystemstatusStatusseite
Aktuelle Serviceinformationen.
Vor dem Produktivbetrieb
Vor dem Produktivbetrieb prüfen.
Bewerten Sie Berechtigungen, Ratenlimits, Wiederholungen, Protokollierung und sensible Daten zusammen mit den Anforderungen Ihrer Anwendung. Webhooks oder Idempotenz dürfen nur im dokumentierten Umfang des jeweiligen Endpunkts genutzt werden.
- BerechtigungGeheimer Schlüssel nur serverseitig, niemals im Clientcode.
- RatenlimitsLimitantworten und Warteintervalle implementieren.
- WiederholungNur bei wiederholbaren Fehlern und mit derselben Referenz.
- ProtokollierungIdentitäts- und Wallet-Daten werden in Protokollen maskiert.
- Umgang mit sensiblen DatenAufbewahrung und Zugriff entsprechend dem Vertragsumfang.
- PrüfzustandFür die Antwort „review_required“ wird ein Teamablauf definiert.
Häufig gestellte Fragen
Über die Integration.
Darf der API-Schlüssel in einer Clientanwendung stehen?
Speichern Sie geheime Zugangsdaten nicht in öffentlich zugänglichem Clientcode. Beachten Sie das Berechtigungsmodell der jeweiligen Integration.
Sind die Beispielantworten Live-Daten?
Dokumentationsbeispiele sind als Beispiele gekennzeichnet. Live-Produktantworten und Testdaten werden getrennt gehalten.
Haben Sie eine technische Frage?
Teilen Sie Ihr Integrationsszenario mit. Klären wir gemeinsam den erforderlichen Produkt- und Datenumfang.