Política de migración y versionado
La API pública preserva la compatibilidad dentro de v1. Los cambios incompatibles requieren una revisión explícita de la política, una entrada en el registro de cambios y una ruta de migración.
Compromisos de compatibilidad
- Pueden incorporarse campos y endpoints aditivos dentro de
v1. - Los campos de respuesta existentes no cambiarán de significado dentro de
v1. - No se añadirán campos de petición obligatorios a las escrituras existentes de
v1sin un plan de compatibilidad. - Las superficies del SDK y de MCP se comprueban contra el mismo modelo de scope y operaciones de OpenAPI.
Qué significa esto para ti
- Tolera campos nuevos y no reconocidos en las respuestas (no falles ante ellos).
- Fija el SDK a una versión conocida y actualiza de forma deliberada.
- Vigila el Registro de cambios para conocer los cambios aditivos.
Política de la fuente
La política de cambios incompatibles se mantiene en docs/developer-platform/openapi-breaking-change-policy.md y se hace cumplir mediante comprobaciones de contrato.