Skip to main content
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.