# Inizia l’integrazione con un ambito chiaro.

> Accedi a documentazione API, SDK e informazioni d’integrazione. Esamina scenari di richiesta, risposta ed errore.

URL canonico: https://legichain.com/it/developers
Lingua: it
Altre lingue (tr): https://legichain.com/developers
Altre lingue (en): https://legichain.com/en/developers
Altre lingue (de): https://legichain.com/de/developers
Altre lingue (es): https://legichain.com/es/developers

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

- [Apri il riferimento API V3](https://legichain.com/it/developers#api-reference)
- [Guida d’integrazione interattiva](https://legichain.com/it/integration-guide)

**Richiesta** — POST /v3/products · Idempotency-Key

```
{
  "product": "aml",
  "name": "Example Customer",
  "retention_years": 0
}
```

**Ricevuta di accettazione** — 202 Accepted

```
{
  "id": "tr_example_result",
  "persona_id": "tr_example_persona",
  "onboarding_id": "tr_example_session",
  "product": "aml",
  "status": "pending",
  "session_token": "SCOPED_SESSION_TOKEN"
}
```

**Formato errore** — 422

```
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "details": {}
  }
}
```

## 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](https://legichain.com/assets/api/openapi-api.json)
- [Servizio compute · OpenAPI JSON](https://legichain.com/assets/api/openapi-compute.json)
- [Servizio media · OpenAPI JSON](https://legichain.com/assets/api/openapi-media.json)
- [Guida all’integrazione · Markdown in inglese](https://legichain.com/assets/api/integration.md)
- **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.

## Prime fasi d’integrazione.

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

- **Scegli il prodotto.** — Definisci il controllo necessario e il suo ambito.
- **Configura l’autenticazione.** — Usa le credenziali API su un server sicuro.
- **Esegui la richiesta di esempio.** — Rispetta le condizioni dell’ambiente di prova.
- **Implementa errori e revisione.** — Non progettare soltanto il caso di successo.

## 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 ambito** — Recupera 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.

**Richiesta di verifica** — POST /v3/products

```json
{
  "product": "wallet_screening",
  "address": "0x1111111111111111111111111111111111111111",
  "chain": "ETH",
  "wallet_depth": 2,
  "retention_years": 0
}
```

**Reti abilitate** — GET /v3/products/wallet-capabilities

```
GET /v3/products/wallet-capabilities
```

**Recupera risultato** — GET /v3/products/{id}

```
GET /v3/products/{id}
```

## Risorse.

- **Guida d’integrazione interattiva** — Scegli controlli e linguaggio per generare una guida passo dopo passo su sessioni, caricamenti diretti e risultati.
  - https://legichain.com/it/integration-guide
- **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.
  - https://legichain.com/it/developers#api-reference
- **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.
  - https://legichain.com/assets/api/integration.md
- **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à.
  - https://legichain.com/it/contact?topic=integration
- **Stato del sistema** — Informazioni attuali sul servizio.
  - https://legichain.com/it/status

## 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.

- **Autorizzazione** — Chiave segreta solo sul server; mai nel codice client.
- **Limiti delle richieste** — Implementa risposte ai limiti e attesa progressiva.
- **Nuovo tentativo** — Solo per errori recuperabili; con lo stesso riferimento.
- **Registrazione delle attività** — Identità e dati del wallet mascherati nei registri.
- **Trattamento dei dati sensibili** — Conservazione e accesso conformi al contratto.
- **Stato di revisione** — Si definisce un flusso del team per la risposta «review_required».

## 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.

- [Richiedi un incontro tecnico](https://legichain.com/it/contact?topic=integration)

---
Legichain — tecnologia per l'identità digitale, AI Video KYC e la valutazione del rischio. Contatto: contact@legichain.com
