Introducción a la API Reference
La API de DVS es una API JSON sobre HTTPS que sigue convenciones REST. Todo endpoint requiere autenticación y vive bajo el path versionado /v1/.
Entornos
DVS expone dos entornos independientes. Todos los ejemplos en esta documentación apuntan a sandbox por defecto — cambiar a producción solo cuando la integración esté validada.
| Entorno | DVS API Base URL | OAuth Token URL |
|---|---|---|
| Sandbox | https://dvs-ingestion-api.sandbox.osigu.com | https://sandbox.osigu.com/v1/oauth/token |
| Producción | https://dvs-ingestion-api.osigu.com | https://api.osigu.com/v1/oauth/token |
Usar sandbox durante la construcción y validación de la integración — mismo contrato de API que producción, pero los datos no son facturables y están aislados. Cambiar a producción solo después de que las pruebas en sandbox pasen.
Las credenciales están limitadas por entorno: el client_id / client_secret emitido para sandbox no funcionará en producción, y viceversa. Cada entorno tiene su propio endpoint OAuth de token.
Autenticación
Todos los endpoints requieren Authorization: Bearer <token>. Ver Obtención de Tokens.
Convenciones
Content type
Todos los bodies son application/json UTF-8.
Identificadores
Todos los IDs de recurso son UUIDs (minúsculas, con guiones).
Timestamps
ISO 8601 UTC (2026-06-03T17:42:18.224Z).
Idempotency
Los endpoints mutadores aceptan Idempotency-Key (UUID) con una ventana de deduplicación de 24h. Ver Idempotency.
Paginación
Los endpoints de listado soportan los query params page (con base 1) y limit (por defecto 50, máx. 200).
Errores
Envelope estándar: { error_code, message, additional_information }. Ver Errores.
Grupos de endpoints
Clasificar documentos por tipo. Sync o async con auto-validate opcional.
Ejecutar extracción + validación contra rule sets. Siempre async.
Descubrir lo que el tenant está autorizado a validar.
Try it out
Cada página de endpoint tiene un panel interactivo "Try it". Pegar el access token en el campo Authorization y ejecutar requests en vivo contra la API.