API
Versionado y cambios
Política#
La versión va en la ruta (/v1/…) y en el cuerpo (schema_version).
v1es 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 (paranext_action, comoHANDOFF_TO_HUMAN).- Los campos de solicitud nuevos son opcionales.
- Un cambio incompatible crea
v2, que convive conv1al 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#
| Fecha | Versión | Cambio |
|---|---|---|
| 2026-10-19 | v1 (vista previa) | Primera publicación de la documentación del contrato channel.validation.v1, channel.validation.result.v1 y channel.error.v1. |