API & Webhooks

Integra NextsID con cualquier sistema

API REST documentada con OpenAPI 3.0: autenticación con JWT, estudios sobre personas y vehículos, puntaje y certificado PDF. Integrala con tu TMS o ERP siguiendo la guía de la documentación.

Los webhooks todavía no están disponibles. La forma del evento y de la firma que se documenta abajo es la definitiva, para que puedas prepararte, pero la entrega aún no está habilitada en producción. Hoy el estado del estudio se consulta conGET /api/v1/checks/{id}.

REST API

Endpoints intuitivos con documentación Swagger interactiva.

Auth JWT

Bearer tokens seguros. API keys para integraciones server-side.

< 100ms latencia

Endpoints de lectura responden en <100ms. Rate limiting inteligente.

JSON + CSV

Responses en JSON. Exports en CSV. Content negotiation.

Webhooks en tiempo real

Recibe notificaciones HTTP al instante cuando algo sucede. Configura URLs por evento, con firma HMAC para verificar autenticidad.

check_completed— El estudio terminó y ya tiene puntaje. Único evento con productor: lo emite el endpoint de scoring.

pre_validation_result— Definido en el contrato, TODAVÍA SIN PRODUCTOR: ningún camino del código lo emite hoy.

Webhook payload example

POST https://tu-sistema.com/webhooks/nextsid
Content-Type: application/json
X-Webhook-Signature: <HMAC-SHA256 del cuerpo, con tu secreto>

{
  "event": "check_completed",
  "check_id": "019fea9a-eb20-7f21-bb50-e539b48b6573",
  "tenant_id": "10000000-0000-0000-0000-000000000001",
  "timestamp": "2026-08-10T14:23:18Z"
}

¿Listo para integrar?

Accede a la documentación completa y obtén tu API key.

Ver documentación Solicitar API Key