Política de Versionado y Deprecación de la API de MenuQR

1. Estrategia de Versionado

MenuQR utiliza versionado explícito en la ruta URL (/api/v1). Todos los cambios retrocompatibles (como la adición de nuevos campos opcionales o nuevos endpoints no destructivos) se introducen directamente dentro de la versión vigente sin alterar contratos existentes.

Cualquier cambio retroincompatible o destructivo requerirá una nueva versión mayor (/api/v2).

2. Plazo Mínimo de Preaviso (180 días)

Cuando un endpoint o funcionalidad sea marcado como obsoleto (deprecated), MenuQR garantiza un período mínimo de soporte activo de 180 días naturales (6 meses) antes del cese definitivo del servicio (sunset).

3. Cabeceras HTTP Estándar (RFC 8594 y RFC 9651)

Durante el ciclo de deprecación, las respuestas del endpoint afectado emitirán cabeceras legibles por máquinas para que agentes y clientes puedan auto-regularse:

• Deprecation: Fecha Unix o indicación de obsolescencia.
• Sunset: Fecha y hora exacta (RFC 1123) en la que el endpoint dejará de responder.
• Link: Enlace rel="deprecation" hacia la guía de migración.

4. Recursos para Desarrolladores

• • Portal de Desarrolladores y Arquitectura de Integración
• • Especificación OpenAPI 3.1 Oficial
• • Directorio Raíz de la API REST v1
• • Servidor Model Context Protocol (MCP)