В этом руководстве объясняется, как Merchant API управляет версиями, выпусками и жизненным циклом различных версий.
Схема управления версиями
API Merchant использует стратегию управления версиями на уровне под-API. Это означает, что каждый API, например, продукты в API Merchant, будет иметь свой собственный жизненный цикл версий.
Формат и представление версий
Стабильные версии под-API: Если под-API находится в стабильной версии, то все его методы также находятся в стабильной версии. Стабильная версия под-API обозначается как vX (например, v1 , v2 ). Это основные версии, готовые к использованию в производстве.
Альфа-версии суб-API: Если суб-API находится в стадии альфа, то все его методы находятся в стадии альфа. Альфа-версия суб-API обозначается как vXalpha (например, v1alpha , v2alpha ). Они содержат экспериментальные функции раннего доступа, предназначенные для тестирования и быстрой итерации. Альфа-версии не гарантируют стабильность, не имеют определённого срока службы и могут быть изменены или прекращены с уведомлением за 30 дней.
Изменения версии
Новые версии (например, с v1 на v2): сигнализируют об обратно несовместимых и критических изменениях, требующих вмешательства разработчика. Только критические изменения стабильных подAPI будут иметь новый номер версии. Например, с v1 на v2.
Незначительные изменения: обратно совместимые дополнения или исправления представлены как изменения к текущей основной версии. Такие изменения будут подробно описаны в примечаниях к выпуску для этой основной версии. Некритичные дополнения к под-API будут выпущены в альфа-канале последней стабильной версии или непосредственно в последней стабильной версии.
Политика заката
Мы периодически прекращаем поддержку старых версий Merchant sub-API. Мы обязуемся установить 12-месячный период прекращения поддержки для стабильных основных версий (vX) с момента официального объявления об прекращении поддержки.
Например, если мы прекратим поддержку v1 под-API Products 15 января 2026 года, то ее действие прекратится не ранее 15 января 2027 года. После этой даты более ранняя версия под-API больше не будет доступна для использования.
Версия Sub-API и статус жизненного цикла
В следующей таблице перечислены последние версии каждого подAPI API Merchant:
| Sub-API | Версии | Статус |
|---|---|---|
| Счета | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Конверсии | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Источники данных | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Запасы | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Разрешение проблем | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Партнерство по местным каналам | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Уведомления | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Отслеживание заказа | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Продукты | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Студия продукта | v1alpha | Активный |
| Акции | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Квота | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Отчеты | v1 v1beta | Активный Будет прекращено 28 февраля 2026 г. |
| Обзоры | v1alpha v1beta | Активный Будет прекращено 28 февраля 2026 г. |
Лучшие практики
- Регулярно проверяйте заметки о выпуске и последние обновления на предмет новых версий, крупных обновлений, улучшений и объявлений о запуске и прекращении поддержки суб-API.
- Если у под-API имеется две или более стабильных версий, мы рекомендуем всегда использовать последнюю версию.
- Разработайте свое приложение так, чтобы оно корректно обрабатывало различные ошибки sub-API, включая сетевые неполадки, ограничения скорости и новые коды ошибок или сообщения, которые могут появиться в новых версиях sub-API.
- Не ждите, пока поддержка какой-либо версии API прекратится, чтобы начать планировать обновление. Начинайте оценивать и тестировать новые версии сразу после их появления.
- Если у вас есть вопросы по функциям или вы хотите задать вопрос о дорожной карте под-API, свяжитесь с нами . Информация о том, как связаться с командой Merchant API для получения технической поддержки, приведена в разделе «Получение помощи с Merchant API» .