Versiones
Versiones principales estables y sustituciones anunciadas.
La ruta /v1 identifica la versión principal. En v1 pueden añadirse campos opcionales, endpoints y nuevos valores de respuesta. Los clientes deben tolerar campos de respuesta desconocidos.
Eliminar campos, añadir parámetros obligatorios y otros cambios incompatibles requiere una nueva versión principal. v1 seguirá disponible en paralelo durante al menos doce meses.
Una ruta obsoleta envía Deprecation, Sunset y un Link a su sustituta. Entre el anuncio y la retirada deben pasar al menos seis meses. Tras la retirada, la ruta devuelve 410 Gone.
CI revisa los cambios de OpenAPI para detectar incompatibilidades. El registro de cambios describe los cambios publicados.