Skip to main content
La API tiene dos niveles de versión:
  • /v1 en la URL. Cambia solo con un rediseño completo de la API.
  • Una versión con fecha, por ejemplo 2026-12-01, que fija la forma exacta de las respuestas.

​
Tu clave fija la versión

Cada clave queda fijada a la versión vigente el día en que se creó. Así, tu integración sigue recibiendo las respuestas con la forma con la que la escribiste. Para usar otra versión en un pedido, mándala en el header Craqui-Version:
Cada respuesta exitosa trae el header Craqui-Version con la versión que se usó. Una versión que no existe responde invalid_api_version.

​
Versiones publicadas

​
Lo que cambia sin una versión nueva

Estos cambios no rompen una integración bien escrita, y llegan a todas las versiones:
  • una ruta nueva;
  • un campo nuevo en una respuesta;
  • un parámetro nuevo opcional;
  • un code de error nuevo;
  • un valor nuevo en un campo que lo avisa en su descripción (por ejemplo, el status de una reserva);
  • un cambio en title o en detail de un error.
Escribe tu código para que tolere esto: ignora los campos que no conoces, y trata un valor o un code que no conoces como el caso genérico.

​
Lo que necesita una versión nueva

Sacar o renombrar un campo, una ruta o un parámetro, cambiar el tipo de un campo o volver obligatorio un parámetro opcional. Un cambio así llega con una versión de fecha nueva: tu clave sigue en la suya hasta que tú decidas mandar la nueva en Craqui-Version. Cada versión nueva se anuncia en Cambios.