Versionado

La API Auvo usa versionado por URL: v2 vive en /v2. Los cambios compatibles (campos opcionales nuevos, nuevos endpoints) entran en v2; los cambios incompatibles pasan a la próxima versión mayor.

• Un endpoint o campo marcado como deprecado permanece al menos 90 días.
• Las deprecaciones aparecen:
  • En x-deprecation-date del spec.
  • En la respuesta, mediante el encabezado Deprecation: @timestamp.
  • En el changelog semanal.
  • Por correo a los administradores de cuentas que usaron el endpoint en los últimos 30 días.

• Nuevos campos opcionales en requests.
• Nuevos campos en responses.
• Nuevos endpoints / nuevos verbos.
• Nuevos códigos 2xx y 4xx con significado adicional.

• Eliminar/renombrar campos o endpoints.
• Cambiar tipos/enums existentes.
• Agregar campos obligatorios en requests.
• Cambiar códigos HTTP en operaciones ya existentes.

Suscríbete a changelog.rss o sigue nuestro feed RSS/Atom. Quienes estén suscritos a Webhooks con el evento api.deprecated también reciben aviso.