Historial de Versiones — API de Validación de Identidad

Registro de cambios, nuevas funcionalidades y advertencias de obsolescencia para la API de Validación de Identidad.

---

v1.0.0 (2026-05-05)

Añadido

• GET /v1/dgii/document/\{document\} — consulta individual por RNC o Cédula
• GET /v1/dgii/document:search — búsqueda por prefijo en 4 campos (name, trade_name, economic_activity, document)
• GET /v1/dgii/registry/status — estado y frescura de la última ingestión
• POST /v1/dgii/document/\{document\}:purge — supresión ARCO (Ley 172-13)

Notas

• Ingestión diaria del registro DGII (~760k registros)
• Latencia p99: <50 ms (consulta), <250 ms (búsqueda)
• Cache público: 5 minutos en consulta individual (Cache-Control: public, max-age=300)
• Búsqueda normaliza automáticamente mayúsculas y acentos

---

Política de versionado

Esta API sigue Versionado Semántico (SemVer):

Tipo de cambio	Incremento	Ejemplo
Nuevo endpoint o campo opcional	Minor	v1.1.0
Corrección de bug (sin cambio de contrato)	Patch	v1.0.1
Cambio incompatible (breaking change)	Major	v2.0.0

Cambios incompatibles (breaking changes)

Los cambios incompatibles se comunican con un mínimo de 30 días de anticipación:

1. Se publica la deprecación en esta página con la fecha de remoción.
2. El endpoint deprecado retorna el header Sunset (RFC 8594) con la fecha de expiración:

   Sunset: Sat, 01 Nov 2026 00:00:00 GMT

3. El header Deprecation (draft-ietf-httpapi-deprecation-header) indica desde cuándo está deprecado:

   Deprecation: Mon, 01 Oct 2026 00:00:00 GMT

4. Tras la fecha de Sunset, el endpoint retorna 410 Gone.

Notificaciones

• Suscríbase al feed de cambios desde el portal de desarrolladores.
• Los cambios se notifican también por email a direcciones registradas con su API key.

---

Convenciones de esta página

• Las versiones se ordenan de más reciente a más antigua.
• Cada versión lista: Añadido, Cambiado, Deprecado, Eliminado, Corregido, Seguridad según Keep a Changelog.