Sviluppatori
Inizia l’integrazione con un ambito chiaro.
Esamina struttura API, campi necessari e risposte. Definisci i controlli adatti al prodotto.
{
"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
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.
- API regionale · OpenAPI JSON
- Servizio compute · OpenAPI JSON
- Servizio media · OpenAPI JSON
- Guida all’integrazione · Markdown in inglese
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.
- 01Scegli il prodotto.
Definisci il controllo necessario e il suo ambito.
- 02Configura l’autenticazione.
Usa le credenziali API su un server sicuro.
- 03Esegui la richiesta di esempio.
Rispetta le condizioni dell’ambiente di prova.
- 04Implementa 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.
{
"product": "wallet_screening",
"address": "0x1111111111111111111111111111111111111111",
"chain": "ETH",
"wallet_depth": 2,
"retention_years": 0
}
GET /v3/products/wallet-capabilities
GET /v3/products/{id}
Risorse
Risorse.
-
Guida d’integrazione interattivaGuida d’integrazione interattiva
Scegli controlli e linguaggio per generare una guida passo dopo passo su sessioni, caricamenti diretti e risultati.
-
API regionale · OpenAPI JSONApri il riferimento API 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.
-
Guida all’integrazione · Markdown in ingleseScarica la guida
Scarica la guida tecnica in inglese per autenticazione, sessioni e media, verifica dei webhook e installazione dei pacchetti dev.2.
-
Consegna SDK e ambito della versioneParliamo della tua integrazione SDK V3
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à.
-
Stato del sistemaPagina di stato
Informazioni attuali sul servizio.
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.