Shopify ограничил Customer Account API по покупателю: что делать при ошибке 429
Customer Account API Shopify получил общий лимит на покупателя. Как проверить повторы запросов, Retry-After и взаимодействие нескольких приложений.
Содержание статьи
Shopify ввёл для Customer Account API лимит 3000 запросов в минуту на одного покупателя в одном магазине. Он общий для всех обращающихся к этому API приложений. Обычная покупательская активность, по оценке платформы, обычно не требует изменений; проверять стоит прежде всего нестандартные интеграции.
Почему несколько приложений считаются вместе
Лимит опубликован 7 октября 2026 года и действует дополнительно к существующему ограничению по стоимости API-запросов. При превышении возвращаются HTTP 429, ошибка THROTTLED и заголовок Retry-After. Платформа рекомендует дождаться указанной паузы перед повтором.
Для владельца магазина это означает, что успешная проверка одного виджета не описывает всю страницу кабинета. Историю заказов, подписки и дополнительные блоки могут загружать разные приложения. Составьте карту этих блоков и ответственных разработчиков; она поможет установить источник лишних обращений.
Что попросить показать в журнале
Нужны время ошибки, используемый интерфейс и поведение повтора. Для первичного разбора подготовьте обезличенный технический сценарий и идентификатор собственного теста. Запишите, какое действие покупателя предшествовало задержке: вход, открытие заказа или обновление блока.
Редакция рекомендует отдельно проверить циклы обновления. Если блок постоянно перерисовывается и снова запрашивает те же сведения, простое увеличение ожидания может скрыть причину. Исполнитель должен показать, какое действие пользователя действительно требует нового обращения.
Как проверить опыт покупателя
Учебный сценарий должен включать загрузку кабинета, обновление страницы и временный ответ 429. После ограничения интерфейс не должен выдавать старую информацию за только что обновлённую. Полезнее понятное сообщение о задержке, чем исчезнувшие заказы или бесконечный индикатор.
Не создавайте нагрузку на рабочем магазине ради достижения порога. Попросите разработчика воспроизвести ответ в своей тестовой среде и показать обработку паузы. Цель проверки — поведение приложения при ограничении, а не количество отправленных запросов.
Критерий завершения работ
Проверка завершена, когда повторы ограничены, пауза учитывается, а после восстановления данные корректно отображаются. Отдельно сохраните результат совместной работы нескольких установленных приложений: общий лимит требует такого сценария.
Для технического контроля используйте логи и показатели собственных приложений. Наличие лимита не означает сбой Shopify и не доказывает проблему конкретного покупателя. Решение принимают по наблюдаемой последовательности обращений и реакции интерфейса.
Материал отражает сведения на указанную дату. Правила и условия работы площадок могут измениться. Редакционные принципы