La API se versiona en la URL: todo vive bajo /v1 (https://api.finzaria.com/v1/…).
Qué es (y qué no) un cambio que rompe
Dentro de /v1 solo hacemos cambios aditivos y compatibles hacia atrás. Diseña tu integración
para tolerarlos:
Aditivo (puede pasar en /v1, no rompe):
- Nuevos endpoints.
- Nuevos campos opcionales en requests.
- Nuevos campos en las respuestas → ignora los que no conozcas.
- Nuevos valores en enums → maneja un default para valores desconocidos.
Rompe (iría a un /v2, nunca en silencio):
- Quitar o renombrar campos o endpoints.
- Cambiar tipos o el significado de un campo.
- Volver obligatorio un parámetro que era opcional.
Deprecaciones
Si algún día deprecamos algo, lo anunciamos en el Changelog con anticipación y una
guía de migración. No retiramos nada sin aviso.
Regla de oro del cliente robusto: ignora campos desconocidos y no asumas el orden de las
llaves JSON. Así los cambios aditivos nunca te rompen.
