VALIDATA Developers

API

Versionado y cambios

Política#

La versión va en la ruta (/v1/…) y en el cuerpo (schema_version).

  • v1 es estable por adición. Solo se añaden campos de respuesta, valores de enumeración y errores nuevos. Tu cliente debe ignorar campos desconocidos de la respuesta y tratar valores de enumeración desconocidos con seguridad (para next_action, como HANDOFF_TO_HUMAN).
  • Los campos de solicitud nuevos son opcionales.
  • Un cambio incompatible crea v2, que convive con v1 al menos 6 meses, con aviso previo.
  • Un código de error nunca se reutiliza con otro significado.
  • Los valores operativos (límites, plazos) pueden ajustarse sin cambiar de versión y se anuncian aquí.

Changelog#

FechaVersiónCambio
2026-10-19v1 (vista previa)Primera publicación de la documentación del contrato channel.validation.v1, channel.validation.result.v1 y channel.error.v1.