Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
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 API secundaria. Esto significa que cada API, por ejemplo, la de Products dentro de la API de Merchant, tendrá su propio ciclo de vida de versiones.
Formato y presentación del control de versiones
Versiones secundarias estables de la API: Si una API secundaria está en una versión estable, todos sus métodos también lo están. Una versión secundaria estable de la API se representa como vX (por ejemplo, v1, v2). Estas son versiones principales listas para producción.
Versiones alfa de sub-APIs: Si una sub-API está en versión alfa, todos sus métodos también lo están. Una versión alfa de la sub-API se representa como vXalpha (por ejemplo, v1alpha, v2alpha). Contienen funciones experimentales de acceso anticipado diseñadas para pruebas y una rápida iteración. Las versiones alfa no tienen garantía de estabilidad, no tienen 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 versión principal (por ejemplo, de v1 a v2): Indican cambios rotundos e incompatibles con versiones anteriores, que requieren la acción del desarrollador.
Solo los cambios rotundos de las sub-APIs estables tendrán un nuevo número de versión. 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 principal. Las incorporaciones que no interrumpen el funcionamiento de una sub-API se lanzarán en el canal alfa de la última versión estable o directamente en la última versión estable.
Política de descontinuación
Periódicamente, retiramos las versiones anteriores de las sub-APIs de Merchant. Nos comprometemos a ofrecer un período de baja de 12 meses para las versiones principales estables (vX), a partir del anuncio oficial de baja.
Por ejemplo, si damos de baja la versión 1 de la sub-API de Products el 15 de enero de 2026, esta dejará de estar disponible a partir 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 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Conversiones
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Fuentes de datos
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Inventarios
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Resolución de problemas
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Asociación de feeds locales
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Notificaciones
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Seguimiento de pedidos
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Productos
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Product Studio
v1alpha
Activo
Promociones
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Cuota
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Informes
v1 v1beta
Activo Se descontinuará el 28 de febrero de 2026
Opiniones
v1alpha v1beta
Activo Se descontinuará el 28 de febrero de 2026
Prácticas recomendadas
Consulta periódicamente 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 sub-APIs.
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 correctamente varios errores de la API secundaria, incluidos los problemas de red, los límites de frecuencia y los nuevos códigos o mensajes de error que se pueden introducir con versiones más recientes de la API secundaria.
No esperes hasta que una versión secundaria de la API 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.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-03 (UTC)"],[],[],null,["This guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\nVersioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\nVersion changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API\n will be released to the alpha channel of the latest stable version or\n directly to the latest stable version.\n\nSunset policy\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reports | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
