# Versionado y cambios

> Qué puede cambiar dentro de v1 y el historial de cambios.

La versión va en la ruta: `/api/v1/`. Dentro de v1 solo se **agregan** cosas: endpoints nuevos, campos nuevos en las respuestas o parámetros opcionales. Quitar un campo, cambiarle el significado o volver obligatorio algo que no lo era es una v2, que convive con v1 un tiempo anunciado.

Escribí tu integración tolerando campos desconocidos en las respuestas y códigos de error nuevos: tratá un código que no conocés según su `recuperacion` y `reintentable`.

La especificación completa está en [openapi.yaml](https://turnovapp.com/docs/openapi.yaml) y [openapi.json](https://turnovapp.com/docs/openapi.json) (OpenAPI 3.1).

## Historial

### 1 de noviembre de 2026: v1

- Catálogo, disponibilidad, crear reserva (con seña por Mercado Pago) y estado de una reserva.
- Claves públicas con orígenes permitidos y claves secretas, con permisos por clave.
- Idempotencia obligatoria al reservar, límites por minuto y formato común de errores.
- Uso diario por clave en el panel. Incluida en el plan Enterprise.