Registro de cambios

Todos los cambios del contrato público v1 se revisan conforme a la política de compatibilidad antes de publicarse. Los cambios aditivos - nuevos endpoints, nuevos campos opcionales de petición, nuevos campos de respuesta, nuevos eventos de webhook - se publican de forma continua dentro de v1 y nunca obligan a migrar.

Qué esperar

• Pueden aparecer nuevos endpoints y campos en cualquier momento. Tolera los campos de respuesta desconocidos en lugar de fallar por ellos.
• Las operaciones v1 existentes y los códigos de estado correctos documentados no se eliminan, y las escrituras existentes no adquieren nuevos parámetros, cuerpos de solicitud ni propiedades JSON obligatorios.
• El mapeo de operaciones del SDK y las herramientas MCP seleccionadas se verifican en CI contra el contrato actual, de modo que sus rutas y ámbitos obligatorios no puedan desviarse silenciosamente.

---

Seguir los cambios

• La Referencia de la API siempre refleja el contrato publicado actualmente: compárala con tu integración al actualizar.
• Los cambios incompatibles se rigen por la Política de migración y versionado, que define la revisión, el preaviso y la ruta de migración exigidos.