# Comienza la integración con un alcance claro.

> Accede a documentación API, SDK e información de integración. Revisa escenarios de solicitud, respuesta y error.

URL canónica: https://legichain.com/es/developers
Idioma: es
Otros idiomas (tr): https://legichain.com/developers
Otros idiomas (en): https://legichain.com/en/developers
Otros idiomas (de): https://legichain.com/de/developers
Otros idiomas (it): https://legichain.com/it/developers

Revisa estructura API, campos necesarios y respuestas. Define los controles adecuados para tu producto.

- [Abrir referencia API V3](https://legichain.com/es/developers#api-reference)
- [Guía de integración interactiva](https://legichain.com/es/integration-guide)

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

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

**Acuse de aceptación** — 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 de error** — 422

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

## Contratos API reales para su integración V3.

Descargue archivos OpenAPI 3.1 separados para la API regional, el procesamiento asignado y el acceso a medios. Utilice sus solicitudes, respuestas, permisos y formatos de error en su integración.

- [API regional · OpenAPI JSON](https://legichain.com/assets/api/openapi-api.json)
- [Servicio de procesamiento · OpenAPI JSON](https://legichain.com/assets/api/openapi-compute.json)
- [Servicio de medios · OpenAPI JSON](https://legichain.com/assets/api/openapi-media.json)
- [Guía de integración · Markdown en inglés](https://legichain.com/assets/api/integration.md)
- **Autenticación en su backend** — Mantenga la clave API Bearer vinculada al workspace en su backend. Las sesiones del panel seleccionan el workspace con X-Workspace-ID. No envíe esa clave a aplicaciones, navegadores ni servidores de procesamiento.
- **Persona y nueva sesión** — Asocie su referencia estable de cliente con POST /v3/personas y cree los servicios seleccionados con POST /v3/onboardings. Entregue al dispositivo solo el session_token de esa sesión y datos de conexión de confianza. Un onboarding nuevo es un nuevo intento; una sesión vacía o en cola no genera cargos.
- **Carga directa al procesamiento asignado** — Acepte una oferta de la cola con claim para recibir compute_url y compute_token. Cargue bytes directamente en ese origen, sin multipart. La grabación con IA envía fragmentos nuevos del mismo grabador. LiveKit solo se usa en videollamadas manuales.
- **Cola y resultados asíncronos** — Siga la cola mediante su endpoint de estado o SSE autenticado. Una respuesta 202 de producto indica aceptación para procesamiento, no aprobación. Consulte el estado final en la API regional. Verifique firmas webhook sobre bytes originales y deduplique los ID; los eventos pueden llegar desordenados.
- **Reintentos, paginación y errores** — Reintente la misma operación con el mismo cuerpo e Idempotency-Key. Pase next_cursor como after para la página siguiente. Actúe según error.code; actualice el estado ante 409 y respete Retry-After en 429/503. Los errores técnicos o de capacidad no son rechazos de identidad.
- **Entrega del SDK y alcance de versión** — El candidato de integración V3 dev.2 incluye paquetes Node, Python, .NET y Java, además de un archivo de fuentes Go. No se ha publicado en registros públicos. Confirme la entrega, la verificación del manifiesto y la validación de plataformas con nuestro equipo. Los archivos OpenAPI no garantizan despliegue ni capacidad.

> Ejemplo sintético V3; no se envía una solicitud real.

## Primeras etapas de integración.

En cuatro etapas, define el alcance, configura el acceso seguro e implementa éxito, revisión y errores.

- **Elige el producto.** — Define el control necesario y su alcance.
- **Configura la autenticación.** — Usa las credenciales API en un servidor seguro.
- **Ejecuta la solicitud de ejemplo.** — Respeta las condiciones del entorno de prueba.
- **Implementa errores y revisión.** — No diseñes únicamente el caso exitoso.

## Elija red y profundidad para analizar carteras.

Consulte primero las redes activas en la respuesta regional wallet-capabilities. Envíe después chain y wallet_depth explícitos: 0 solo para listas de direcciones, 1 para contrapartes directas, 2 para directas e indirectas. La profundidad predeterminada es 2; códigos de activos como USDT no identifican una red.

- **Lea los resultados asíncronos con su alcance** — Obtenga GET /v3/products/{id} con el id de la creación. potential_match es un hallazgo en listas para revisión. no_match significa ausencia de coincidencias en la cobertura completada. inconclusive indica consulta incompleta; no lo use como aprobación automática. Conserve trace.complete, reasons, coverage, limitations y snapshot.

> Se rechazan redes o direcciones inválidas y proveedores regionales inactivos antes de cobrar créditos. Mantenga las credenciales de API en el servidor. La dirección siguiente es solo un ejemplo de sintaxis; este ejemplo no realiza solicitudes de red.

**Solicitud de consulta** — POST /v3/products

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

**Redes habilitadas** — GET /v3/products/wallet-capabilities

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

**Obtener resultado** — GET /v3/products/{id}

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

## Recursos.

- **Guía de integración interactiva** — Elija controles y lenguaje para generar una guía paso a paso de sesiones, cargas directas y resultados.
  - https://legichain.com/es/integration-guide
- **API regional · OpenAPI JSON** — Descargue archivos OpenAPI 3.1 separados para la API regional, el procesamiento asignado y el acceso a medios. Utilice sus solicitudes, respuestas, permisos y formatos de error en su integración.
  - https://legichain.com/es/developers#api-reference
- **Guía de integración · Markdown en inglés** — Descargue la guía técnica en inglés sobre autenticación, sesiones y medios, verificación de webhooks e instalación de paquetes dev.2.
  - https://legichain.com/assets/api/integration.md
- **Entrega del SDK y alcance de versión** — El candidato de integración V3 dev.2 incluye paquetes Node, Python, .NET y Java, además de un archivo de fuentes Go. No se ha publicado en registros públicos. Confirme la entrega, la verificación del manifiesto y la validación de plataformas con nuestro equipo. Los archivos OpenAPI no garantizan despliegue ni capacidad.
  - https://legichain.com/es/contact?topic=integration
- **Estado del sistema** — Información actual del servicio.
  - https://legichain.com/es/status

## Comprueba antes de pasar a producción.

Evalúa permisos, límites de solicitudes, reintentos, registros y datos sensibles según tu aplicación. Utiliza webhooks o idempotencia solo dentro del alcance documentado del endpoint correspondiente.

- **Autorización** — Clave secreta solo en servidor; nunca en código cliente.
- **Límites de solicitudes** — Implementa respuestas de límite y espera progresiva.
- **Reintento** — Solo ante errores recuperables; con la misma referencia.
- **Registro de actividad** — Identidad y datos de cartera enmascarados en los registros.
- **Tratamiento de datos sensibles** — Conservación y acceso conformes al contrato.
- **Estado de revisión** — Se define un flujo del equipo para la respuesta «review_required».

## Sobre la integración.

### ¿Puedo incluir la clave API en una aplicación cliente?

No incluyas secretos en código cliente de acceso público. Sigue el modelo de autorización de la integración correspondiente.

### ¿Las respuestas de ejemplo son datos reales?

Los ejemplos están identificados como tales. Respuestas del producto real y datos de prueba se mantienen separados.

## ¿Tienes una consulta técnica?

Comparte tu escenario de integración. Aclaremos juntos producto y datos necesarios.

- [Solicitar reunión técnica](https://legichain.com/es/contact?topic=integration)

---
Legichain — tecnología para identidad digital, AI Video KYC y evaluación de riesgos. Contacto: contact@legichain.com
