Sviluppatori

Inizia l’integrazione con un ambito chiaro.

Esamina struttura API, campi necessari e risposte. Definisci i controlli adatti al prodotto.

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

OpenAPI 3.1 · V3

Contratti API effettivi per la tua integrazione V3.

Scarica file OpenAPI 3.1 separati per l’API regionale, il compute assegnato e l’accesso ai media. Usa richieste, risposte, permessi e formati di errore nella tua integrazione.

Autenticazione nel tuo backend

Mantieni la chiave API Bearer associata al workspace nel tuo backend. Le sessioni del pannello scelgono il workspace con X-Workspace-ID. Non inviare la chiave ad app, browser o host di compute.

Persona e nuova sessione

Associa il riferimento stabile del cliente con POST /v3/personas, poi crea i servizi scelti con POST /v3/onboardings. Fornisci al dispositivo solo il session_token limitato alla sessione e dati di connessione attendibili. Un nuovo onboarding è un nuovo tentativo; le sessioni vuote e l’attesa in coda non vengono addebitate.

Caricamento diretto sul compute assegnato

Accetta un’offerta della coda con claim per ricevere compute_url e compute_token. Carica i byte direttamente su quell’origine, senza multipart. La registrazione IA invia nuovi frammenti dello stesso registratore. LiveKit è usato solo per le videochiamate manuali.

Coda e risultati asincroni

Segui la coda tramite l’endpoint di stato o SSE autenticato. Una risposta prodotto 202 indica accettazione per l’elaborazione, non approvazione. Leggi lo stato finale dall’API regionale. Verifica le firme webhook sui byte originali e deduplica gli ID; gli eventi possono arrivare fuori ordine.

Tentativi, paginazione ed errori

Ripeti la stessa modifica con corpo e Idempotency-Key identici. Usa next_cursor come after per la pagina successiva. Gestisci error.code; aggiorna lo stato per 409 e rispetta Retry-After per 429/503. Gli errori tecnici o di capacità non sono rifiuti d’identità.

Consegna SDK e ambito della versione

Il candidato d’integrazione V3 dev.2 include pacchetti Node, Python, .NET e Java e un archivio sorgente Go. Non è stato pubblicato in registri pubblici. Concorda consegna, verifica del manifesto e validazione delle piattaforme con il nostro team. I file OpenAPI non costituiscono un impegno di distribuzione o capacità.

Esempio sintetico V3; nessuna richiesta reale.

Primi passi

Prime fasi d’integrazione.

In quattro fasi, definisci l’ambito, configura l’accesso sicuro e implementa successo, revisione ed errori.

  1. 01
    Scegli il prodotto.

    Definisci il controllo necessario e il suo ambito.

  2. 02
    Configura l’autenticazione.

    Usa le credenziali API su un server sicuro.

  3. 03
    Esegui la richiesta di esempio.

    Rispetta le condizioni dell’ambiente di prova.

  4. 04
    Implementa errori e revisione.

    Non progettare soltanto il caso di successo.

Analisi delle relazioni delle transazioni

Scegli rete e profondità per la verifica del portafoglio.

Leggi prima le reti abilitate dalla risposta regionale wallet-capabilities. Invia poi chain e wallet_depth espliciti: 0 solo per le liste di indirizzi, 1 per le controparti dirette, 2 per dirette e indirette. La profondità predefinita è 2; i codici di asset come USDT non identificano una rete.

  • Leggi i risultati asincroni con il relativo ambitoRecupera GET /v3/products/{id} usando l’id restituito alla creazione. potential_match è una corrispondenza nelle liste da esaminare. no_match indica assenza di corrispondenze nella copertura completata. inconclusive indica verifica incompleta, non approvazione automatica. Conserva trace.complete, reasons, coverage, limitations e snapshot.

Reti o indirizzi non validi e fornitori regionali inattivi vengono rifiutati prima dell’addebito dei crediti. Mantieni le credenziali API sul server. L’indirizzo seguente è solo un esempio di sintassi; l’esempio non effettua richieste di rete.

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

Risorse

Risorse.

  • Guida d’integrazione interattiva

    Scegli controlli e linguaggio per generare una guida passo dopo passo su sessioni, caricamenti diretti e risultati.

    Guida d’integrazione interattiva
  • API regionale · OpenAPI JSON

    Scarica file OpenAPI 3.1 separati per l’API regionale, il compute assegnato e l’accesso ai media. Usa richieste, risposte, permessi e formati di errore nella tua integrazione.

    Apri il riferimento API V3
  • Guida all’integrazione · Markdown in inglese

    Scarica la guida tecnica in inglese per autenticazione, sessioni e media, verifica dei webhook e installazione dei pacchetti dev.2.

    Scarica la guida
  • Consegna SDK e ambito della versione

    Il candidato d’integrazione V3 dev.2 include pacchetti Node, Python, .NET e Java e un archivio sorgente Go. Non è stato pubblicato in registri pubblici. Concorda consegna, verifica del manifesto e validazione delle piattaforme con il nostro team. I file OpenAPI non costituiscono un impegno di distribuzione o capacità.

    Parliamo della tua integrazione SDK V3
  • Stato del sistema

    Informazioni attuali sul servizio.

    Pagina di stato

Prima della produzione

Verifica prima di andare in produzione.

Valuta autorizzazioni, limiti delle richieste, tentativi, registri e dati sensibili secondo l’applicazione. Usa webhook o idempotenza solo nell’ambito documentato dell’endpoint pertinente.

  • AutorizzazioneChiave segreta solo sul server; mai nel codice client.
  • Limiti delle richiesteImplementa risposte ai limiti e attesa progressiva.
  • Nuovo tentativoSolo per errori recuperabili; con lo stesso riferimento.
  • Registrazione delle attivitàIdentità e dati del wallet mascherati nei registri.
  • Trattamento dei dati sensibiliConservazione e accesso conformi al contratto.
  • Stato di revisioneSi definisce un flusso del team per la risposta «review_required».

Domande frequenti

Sull’integrazione.

Posso inserire la chiave API in un’app client?

Non inserire segreti nel codice client accessibile pubblicamente. Segui il modello di autorizzazione dell’integrazione pertinente.

Le risposte di esempio sono dati reali?

Gli esempi sono identificati come tali. Risposte del prodotto reale e dati di prova restano separati.

Hai una domanda tecnica?

Condividi lo scenario d’integrazione. Chiariamo insieme prodotto e dati necessari.