Versiones y OpenAPI

Desarrolla contra el contrato explícito /api/v1 y el documento OpenAPI descargable.

Versión de la API

Versión de la API: La versión de la URL identifica el contrato público de la API.
Versión de Engine: El número de versión de Engine en OpenAPI identifica la implementación que exportó el documento; no es el expected_version del recurso.
Versión del recurso: Trata las versiones de los recursos como valores para controlar cambios simultáneos y obténlas de respuestas actuales.

Conserva el contrato descargado junto con los tests de tu integración.
Al actualizarla, revisa los campos obligatorios, los valores enumerados admitidos y los esquemas de respuesta.