> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craqui.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Versiones

> Cómo se versiona la API y qué cambios pueden llegar sin que cambies nada.

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`:

```bash theme={null}
curl -s https://api.craqui.com/v1/business \
  -H "Authorization: Bearer $CRAQUI_API_KEY" \
  -H "Craqui-Version: 2026-12-01"
```

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`](https://docs.craqui.com/errors/invalid_api_version).

## Versiones publicadas

| Versión | Qué trae |
| - | - |
| `2026-12-01` | La primera versión. Lee [Cambios](https://docs.craqui.com/changelog.md). |

## 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](https://docs.craqui.com/changelog.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.