Entwickler

Integration mit klarem Umfang beginnen.

Prüfen Sie API-Struktur, erforderliche Datenfelder und Antworten. Definieren Sie den passenden Kontrollablauf für Ihr Produkt.

Beispieldaten
POST /v3/products · Idempotency-Key
{
  "product": "aml",
  "name": "Example Customer",
  "retention_years": 0
}

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.

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.

  1. 01
    Produkt wählen.

    Benötigte Kontrolle und deren Umfang festlegen.

  2. 02
    Authentifizierung einrichten.

    API-Zugangsdaten nur in einer sicheren Serverumgebung verwenden.

  3. 03
    Beispielanfrage ausführen.

    Nutzungsbedingungen der Testumgebung beachten.

  4. 04
    Fehler- 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.

Beispieldaten
POST /v3/products
{
  "product": "wallet_screening",
  "address": "0x1111111111111111111111111111111111111111",
  "chain": "ETH",
  "wallet_depth": 2,
  "retention_years": 0
}

Ressourcen

Ressourcen.

  • Interaktiver Integrationsleitfaden

    Wählen Sie Prüfungen und Codesprache und erstellen Sie einen Schritt-für-Schritt-Leitfaden für Sitzungen, direkte Uploads und Ergebnisse.

    Interaktiver Integrationsleitfaden
  • Regionale API · OpenAPI JSON

    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.

    V3-API-Referenz öffnen
  • Integrationsleitfaden · englisches Markdown

    Laden Sie den englischen technischen Leitfaden zu Authentifizierung, Sitzungen und Medien, Webhook-Prüfung und Installation der dev.2-Pakete herunter.

    Leitfaden herunterladen
  • 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.

    V3-SDK-Integration besprechen
  • Systemstatus

    Aktuelle Serviceinformationen.

    Statusseite

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.