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

# Versionado y deprecación

> Cómo evoluciona la API y cómo se anuncian las eliminaciones

La API se versiona en la ruta: `/v1`.

## Aditivo dentro de una versión

Dentro de `v1`, los cambios son **aditivos**. Pueden aparecer endpoints y campos de respuesta nuevos en cualquier momento; un campo existente nunca se elimina, se renombra ni cambia de significado. Escribe clientes que **ignoren los campos desconocidos**: uno nuevo no es un cambio incompatible y llegará sin previo aviso.

Un cambio que rompería una integración existente, como eliminar un campo, cambiar un tipo o cambiar un valor por defecto, sale como una nueva versión mayor (`/v2`), nunca dentro de `v1`.

## Deprecación

Todo lo que está por retirarse se marca `deprecated` en estas páginas de referencia y en el documento OpenAPI antes de eliminarse. Un endpoint deprecado sigue funcionando durante su periodo de aviso. Cuando un encabezado de respuesta lleva información de deprecación, sigue las convenciones del IETF (`Deprecation` y `Sunset`).

## El contrato

Estas páginas se generan a partir del documento OpenAPI de wondeya, el mismo contrato que sirve el servidor. Es la fuente de verdad de lo que una ruta acepta y devuelve; cuando este y la prosa no coinciden, el documento OpenAPI es el que tiene razón.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.