Инструкция для администратора и разработчика внешнего сервиса. Это последовательная диагностика, а не обещание единственной причины по сообщению об ошибке. Рабочие доступы, платежи и кассовые документы не меняйте ради проверки. Сначала сохраните обезличенный пример и уточните используемую версию интеграции.
Как проявляется проблема
- После массового запуска появляется ответ 429.
- Одиночное чтение проходит, параллельный обмен отклоняется.
Что проверить сначала
- Несогласованные задачи обращаются одновременно.
- Повторы увеличивают исходную нагрузку.
- Ответ создаёт промежуточный сервис, а не выбранный API.
Быстрая диагностика
| Что наблюдаем | Что проверить | Как понять результат |
|---|---|---|
| Ответ429 | Проверить конечный URL и исходный ответ. | Если ограничил прокси, разбирать его; иначе — конкретный API. |
| Ошибки только при массовом запуске | Посчитать одновременно работающие задачи. | При повторных запусках объединить управление очередью. |
| Повторы растут | Сравнить количество новых задач и повторов. | Ограничить повторное чтение; команды сначала сверить. |
Три точки наблюдения
Полная формулировка из статьи
Проверить конечный URL и исходный ответ. Посчитать одновременно работающие задачи. Сравнить количество новых задач и повторов.
Маршрут диагностики
Маршрут проверок
Полная формулировка из статьи
Шаг 1. Сохраните один полный ответ с URL, заголовками и временем. Отделите внешний HTTP-статус от кода внутри JSON. Если приложение показывает только «лимит», попросите исходный ответ. По нему выясняйте, ограничил ли запрос iiko, собственный шлюз, хостинг или клиентская библиотека; одинаковая надпись на экране этого не доказывает. Шаг 2. Уточните семейство методов. В прочитанной спецификации 429 явно предусмотрен для части inventory/v1. Это не подтверждает единое правило для каждого метода заказов или меню. Найдите ограничения именно своего endpoint и контракта; если они неизвестны, зафиксируйте вопрос поставщику вместо произвольного числа запросов в минуту. Шаг 4. Для безопасного чтения согласуйте очередь с ограниченной параллельностью и паузой повторов. Если ответ содержит Retry-After, учитывайте его по поддерживаемому формату. При отсутствии подсказки используйте согласованную политику поставщика. Повтор создания заказа отделите от чтения: сначала установите результат прежней операции, чтобы не получить вторую запись. Шаг 6. Возобновляйте обмен постепенно с наблюдением за очередью. Зафиксируйте число входящих задач, завершений и отказов. Если очередь растёт, даже когда число запросов снизилось, оцените длительность операций и ошибки отдельно. После восстановления сверьте незавершённые заказы по одному, а не отправляйте весь накопленный список повторно.
Скриншоты и фрагменты документации
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Редакционная визуализация фрагмента OpenAPI, не скриншот интерфейса iikoCloud API — официальный справочник OpenAPI. Нажмите на изображение, чтобы открыть отдельно. Сверяйте источник с версией и настройками своей системы.
Пошаговое решение
Отмечайте выполненные проверки. Отметки действуют до перезагрузки страницы.
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko. 
Иллюстрация рабочего процесса; сгенерированное фото, не интерфейс iiko.
Развилка результата
Полная формулировка из статьи
Критерий результата: При согласованной нагрузке очередь сокращается, контрольные чтения проходят, а прежние операции не размножаются. Уменьшение числа отказов сопровождается фактическим обновлением данных; отсутствие обращений в журнале само по себе не считается восстановлением. Передача специалисту: Передайте поставщику один воспроизводимый пример: время с часовым поясом, используемый метод, версии компонентов и обезличенные запрос с ответом. Добавьте результат каждого шага и ожидаемое поведение. Не передавайте секреты в обычном журнале; укажите correlationId, если он получен.
Как понять, что проблема решена
При согласованной нагрузке очередь сокращается, контрольные чтения проходят, а прежние операции не размножаются. Уменьшение числа отказов сопровождается фактическим обновлением данных; отсутствие обращений в журнале само по себе не считается восстановлением.
Как снизить риск повторения
Используйте единую политику нагрузки для фоновых задач и ручных запусков. Отдельно наблюдайте очередь повторов и свежесть меню. При добавлении филиалов проверяйте суммарное количество обращений, а не только скорость одного ресторана.
Если проблема осталась
Передайте поставщику один воспроизводимый пример: время с часовым поясом, используемый метод, версии компонентов и обезличенные запрос с ответом. Добавьте результат каждого шага и ожидаемое поведение. Не передавайте секреты в обычном журнале; укажите correlationId, если он получен.
Что передать в поддержку
Скопируйте шаблон и заполните его без паролей, API-ключей, данных карт и сведений о гостях.
Проблема: iiko API: слишком много запросов и 429 — что проверить Версия и компонент iiko: Ресторан / рабочее место: Время сбоя и часовой пояс: Точный текст сообщения: Что ожидалось / что произошло: Какие проверки выполнены: Результат каждой проверки: Идентификатор операции (если допустимо):
Где помогает Menu 360
Menu 360 интегрируется с iiko и поддерживает автоматические допродажи. Для стабильной работы цифрового меню важны актуальные данные без лишнего опроса. Цены задаются в самом Menu 360; восстановив обмен, проверьте связку основного блюда с предложенной добавкой и результат заказа. Настройка рекламы не заменяет контроль очереди интеграции.
Вопросы и ответы
Сколько запросов в минуту разрешает iikoCloud?
Одного подтверждённого числа для всех методов здесь нет. Проверьте семейство API, restriction group и действующие условия поставщика. Число из обёртки или стороннего MCP-сервера не является автоматически лимитом iiko.
Можно решить проблему несколькими API-ключами?
Сначала исправьте дубли задач и бесконтрольные повторы. Дополнительные ключи не устраняют ошибку планировщика и усложняют контроль нагрузки. Изменение схемы доступа должно быть частью согласованной архитектуры, а не способом скрыть отказ.
Источники и применимость
Официальная документация служит основой проверки возможностей iiko. Последовательность диагностики и контрольные примеры разработаны редакцией Menu 360; это не подтверждение ошибки именно в вашей конфигурации.