En esta guía, se explica cómo la API de Merchant controla el control de versiones, las versiones y el ciclo de vida de sus diferentes versiones.
Esquema del control de versiones
La API de Merchant emplea una estrategia de control de versiones a nivel de la sub-API. Esto significa que cada API de Merchant, por ejemplo, Products en la API de Merchant, tendrá su propio ciclo de vida de versiones.
Formato y presentación de las versiones
Versiones estables de las sub-APIs: Si una sub-API está en una versión estable, todos sus métodos están en una versión estable. Una versión estable de la sub-API se representa como vX (por ejemplo, v1, v2). Estas son versiones principales listas para producción.
Versiones alfa de las sub-APIs: Si una sub-API está en fase alfa, todos sus métodos están en fase alfa. Una versión alfa de la sub-API se representa como vXalpha (por ejemplo, v1alpha, v2alpha). Contienen funciones experimentales de acceso anticipado destinadas a pruebas y a iteraciones rápidas. Las versiones alfa no tienen garantía de estabilidad ni una vida útil definida, y se pueden cambiar o descontinuar con un período de aviso de 30 días.
Cambios en la versión
- Incrementos de versiones principales (por ejemplo, de v1 a v2): Indican cambios rotundos y no retrocompatibles, que requieren la acción del desarrollador. Solo los cambios rotundos de las APIs secundarias estables tendrán un número de versión nuevo. Por ejemplo, de v1 a v2.
- Cambios menores: Las adiciones o correcciones retrocompatibles se presentan como cambios en la versión principal existente. Estos cambios se detallarán en las notas de la versión de esa versión principal. Las adiciones no disruptivas a una API secundaria se lanzarán en el canal alfa de la versión estable más reciente o directamente en la versión estable más reciente.
Política de baja
Periódicamente, retiramos las versiones anteriores de la API secundaria de Merchant. Nos comprometemos a un período de baja de 12 meses para las versiones principales estables (vX), a partir del anuncio oficial de baja.
Por ejemplo, si dejamos de admitir la versión 1 de la sub-API de Products el 15 de enero de 2026, esta se dará de baja no antes del 15 de enero de 2027. Después de esta fecha, la versión anterior de la sub-API ya no estará disponible para su uso.
Versión de la API secundaria y estado del ciclo de vida
En la siguiente tabla, se enumeran las versiones más recientes de cada sub-API de la API de Merchant:
| Sub-API | Versiones | Estado |
|---|---|---|
| Cuentas | v1 v1alpha |
Activas Activas |
| Conversiones | v1 | Activo |
| Fuentes de datos | v1 | Activo |
| Inventarios | v1 | Activo |
| Resolución de problemas | v1 | Activo |
| Asociación de feeds locales | v1 | Activo |
| Notificaciones | v1 | Activo |
| Seguimiento de pedidos | v1 | Activo |
| Productos | v1 | Activo |
| Product Studio | v1alpha | Activo |
| Promociones | v1 | Activo |
| Cuota | v1 | Activo |
| Informes | v1 | Activo |
| Opiniones | v1alpha | Activo |
Prácticas recomendadas
- Consulta con frecuencia las notas de la versión y las actualizaciones más recientes para conocer las versiones nuevas, las actualizaciones importantes, las mejoras y los anuncios sobre los lanzamientos y las bajas de las APIs secundarias.
- Si una sub-API tiene dos o más versiones estables, te sugerimos que uses la versión más reciente en todo momento.
- Diseña tu aplicación para que controle con facilidad varios errores de las APIs secundarias, incluidos los problemas de red, los límites de frecuencia y los nuevos códigos de error o mensajes que podrían presentarse con las versiones más recientes de las APIs secundarias.
- No esperes hasta que una versión de la API secundaria esté a punto de dejar de estar disponible para comenzar a planificar la actualización. Comienza a evaluar y probar las versiones nuevas en cuanto estén disponibles.
- Para solicitar funciones o expresar inquietudes sobre la hoja de ruta de una sub-API, comunícate con nosotros para enviarnos preguntas o comentarios. Para obtener información sobre cómo comunicarte con el equipo de la API de Merchant y obtener asistencia técnica, consulta Obtén ayuda con la API de Merchant.