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

# Versionado

> Cómo se versiona la API y qué cambios son compatibles.

La versión va en la ruta. La versión actual es **v1**:

```
https://api-v2.riqra.com/public/v1
```

## Cambios compatibles

Dentro de `v1` agregamos funcionalidad de forma **aditiva**. Estos cambios no rompen tu
integración y pueden ocurrir sin aviso:

* Nuevos endpoints.
* Nuevos campos opcionales en una respuesta.
* Nuevos valores en un campo de tipo enumerado.
* Nuevos parámetros opcionales en una request.

<Note>
  Diseña tu integración para tolerar campos y valores nuevos: ignora los campos que no conozcas y
  no falles ante un valor de enum inesperado.
</Note>

## Cambios incompatibles

Un cambio que rompa el contrato (quitar un campo, cambiar un tipo, cambiar el significado de un
valor) se publicaría bajo una nueva versión de ruta (`/public/v2`), no dentro de `v1`.

## Especificación

La especificación OpenAPI de la API está disponible en:

```
https://api-v2.riqra.com/public/v1/openapi.json
```