Toda la API pública vive bajo el prefijo **`/public/v1`**, explícito en cada ruta.

## Qué prometemos dentro de `/public/v1`

Mientras una integración exista bajo `/public/v1`, **nunca**:

- se retira un campo de una respuesta,
- se cambia el tipo de un campo existente,
- se endurece una validación de forma que un cuerpo antes válido deje de serlo.

Añadir un campo nuevo a una respuesta, un endpoint nuevo, o un parámetro de filtro opcional nuevo **sí** es
compatible — tu integración debe ignorar campos que no reconozca, nunca fallar por su presencia.

## Qué pasa con un cambio incompatible

Un cambio que rompiera lo de arriba nace en un router nuevo, `/public/v2`, nunca modificando `/public/v1` in
situ. `/public/v1` sigue funcionando un mínimo de **6 meses** después de publicarse `/public/v2` — durante
esa ventana, toda respuesta de un endpoint marcado para retirada incluye las cabeceras estándar
([RFC 8594](https://www.rfc-editor.org/rfc/rfc8594)):

```
Deprecation: true
Sunset: Wed, 01 Jul 2026 00:00:00 GMT
```

No hay ningún endpoint deprecado hoy — si alguno lo estuviera, esta página lo listaría explícitamente, con su
fecha de retirada y su sustituto en `/public/v2`.