Política de API

Versionado y deprecación predecibles

La API informativa de Comunicar Más es pública, gratuita, sin registro y de solo lectura. Esta política explica cómo se comunicarán los cambios para que agentes e integraciones no dependan de contratos inestables.

Versión vigente

La versión estable actual es v1 y forma parte de la ruta /api/v1/. Las adiciones compatibles, como nuevos campos opcionales, pueden publicarse dentro de v1. Un cambio que elimine campos, altere su significado o exija nuevos parámetros obligatorios se publicará bajo una nueva versión mayor.

Deprecación y retiro

Comunicar Más procurará avisar con al menos seis meses de anticipación antes de retirar una versión pública. Cuando exista una fecha programada, las respuestas afectadas incluirán los headers HTTP Deprecation y Sunset, junto con un enlace a la versión sucesora o a la guía de migración. No se envían esos headers mientras v1 siga vigente y sin fecha de retiro.

Canales de aviso

Los cambios se reflejarán en la documentación pública, el contrato OpenAPI y llms.txt. Para una consulta técnica, utiliza el correo público indicado en la página de contacto sin compartir antecedentes clínicos.