Saltar al contenido principal

Control de versiones

La API de Ordering incluye la versión de su contrato en la ruta de cada solicitud dirigida a un tenant:

https://api.ordering.co/{version}/{lang}/{project}/{resource}

Por ejemplo:

POST https://api.ordering.co/v400/en/YOUR_PROJECT/auth
  • version selecciona el contrato de API, como v400.
  • lang selecciona el idioma usado por las respuestas de la API; es independiente del idioma de la interfaz de documentación.
  • project selecciona el tenant de Ordering.

El formato de ruta acepta una v minúscula seguida de dígitos, pero el servidor solo sirve las versiones habilitadas en la configuración del entorno de ejecución. Una versión no admitida devuelve 404 con una respuesta vacía.

Una versión diferente puede resolver a una implementación distinta del mismo controlador. Fija las integraciones a la versión con la que se crearon y probaron, y revisa la versión de destino antes de actualizar. El segmento de versión no garantiza por sí solo compatibilidad hacia atrás con otra versión.