Versión en la ruta · 180 días de aviso · Cabeceras Deprecation y Sunset
Versionado de la API.
La versión va en la ruta. Una integración que fija una versión conserva el contrato con el que se escribió, y nunca lo pierde sin aviso.
Cómo funcionan las versiones
Un número, en la ruta, que solo cambia ante una ruptura.
GET https://ecentic.ai/api/v1/discovery
API-Version: 1La versión actual es v1, servida en `/api/v1`. Cada respuesta repite además la versión en una cabecera `API-Version`, de modo que un cliente que siga una redirección o un enlace pueda confirmar con qué está hablando realmente.
Los cambios aditivos se publican dentro de una versión: endpoints nuevos, campos opcionales nuevos en las peticiones, campos nuevos en una respuesta existente. Trata los campos de respuesta desconocidos como compatibilidad hacia delante, no como un error.
Un cambio que elimina un campo, lo renombra, estrecha un tipo o cambia el significado de un valor existente es un cambio incompatible y se publica como una ruta de versión nueva junto a la anterior — nunca en el mismo sitio.
Obsolescencia y retirada
Dos cabeceras estándar y una ventana suficiente para reaccionar.
Cuando una versión queda obsoleta, todas sus respuestas llevan una cabecera `Deprecation` (RFC 9745). Cuando hay fecha de retirada, las respuestas llevan además una cabecera `Sunset` (RFC 8594) con la fecha en que la versión deja de responder, y un `Link` con `rel="successor-version"` que apunta al reemplazo.
El aviso mínimo entre el anuncio de obsolescencia y la fecha de retirada es de 180 días. Ninguna versión se retira sin haber servido ambas cabeceras durante esa ventana completa.
Deprecation: @1780272000
Sunset: Sat, 01 Aug 2026 00:00:00 GMT
Link: <https://ecentic.ai/api/v2>; rel="successor-version"Qué no se versiona
Los documentos de descubrimiento siguen la versión de su propio protocolo.
Los documentos de descubrimiento en `.well-known` se versionan según el protocolo que implementan, no según la versión de la API de ecentic — el perfil UCP lleva una versión de UCP, la tarjeta de servidor MCP lleva una versión de protocolo, y así con el resto. Leer la versión dentro del documento siempre es correcto; deducirla de la versión de la API de ecentic no lo es.
¿Listo para ser el producto que recomiendan los agentes?
Instálalo gratis en Shopify o WooCommerce y mira tu puntuación de IA en minutos.
Instalar en Shopify
Instalar en WooCommerce
© 2026 ecentic. Todos los derechos reservados.
Hecho para comercios que se niegan a ser invisibles para la IA.