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

# Versionado

> Cómo versiona Finzaria su API y qué esperar de cambios y deprecaciones.

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](/changelog) con anticipación y una
guía de migración. No retiramos nada sin aviso.

<Tip>
  **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.
</Tip>