Toda la API pública vive bajo el prefijo /public/v1, explícito en cada ruta.
Qué prometemos dentro de /public/v1
Sección titulada «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
Sección titulada «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):
Deprecation: trueSunset: Wed, 01 Jul 2026 00:00:00 GMTNo 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.