Ограничения на обращения и ответы сервиса для внешних подключений
Сколько обращений в минуту допустимо для подключённых внешних систем и что означает каждый ответ сервиса — справка в разделе «Подключения».
Ограничения на обращения и ответы сервиса для внешних подключений
Зачем это нужно: когда вы подключаете к гостинице внешнюю систему — ресторан, программу учёта, чат-бот — она постоянно обращается за данными: узнаёт брони, свободные номера, цены. Чтобы одна система случайно не «завалила» сервис тысячей обращений в секунду и не замедлила работу для всех, действует разумное ограничение на частоту обращений. А чтобы разработчик подключённой системы понимал, почему очередное обращение не прошло, сервис на каждое обращение возвращает короткий ответ-статус.
В разделе «Подключения» есть отдельная справка, где всё это собрано в одном месте: сколько обращений в минуту допустимо и что означает каждый ответ сервиса. Эту страницу удобно показать или переслать специалисту, который настраивает внешнюю систему.
Шаг 1. Открыть справку «Ограничения и ответы сервиса»
Перейдите в Настройки (пункт в главном меню слева) и выберите вкладку «Подключения». Над списком подключений нажмите кнопку «Ограничения и ответы сервиса».
Кнопка находится рядом с кнопкой создания подключения — открывает справочную страницу, ничего в ваших подключениях при этом не меняется.
Шаг 2. Посмотреть ограничение на количество обращений
В верхнем блоке крупно показано, сколько обращений в минуту допустимо с одного адреса.
Здесь всё просто: если внешняя система обращается слишком часто и превышает это число, сервис на время отвечает отказом «слишком много обращений». Нужно сделать паузу и повторить позже — счётчик обнуляется каждую минуту. Совет для разработчика внешней системы прямо на странице: распределяйте обращения равномерно, а не отправляйте их одной большой пачкой.
Шаг 3. Разобраться, что означают ответы сервиса
Ниже расположена таблица ответов. На каждое обращение сервис возвращает короткий ответ-статус — по нему сразу видно, всё ли в порядке или что именно пошло не так.
Читается она так:
- Запрос выполнен — всё в порядке, данные получены или сохранены.
- Неверный запрос — не хватает нужных данных или они заданы неправильно; проверьте их на стороне внешней системы.
- Неверный ключ доступа — идентификатор или секретный ключ указан с ошибкой; сверьте данные подключения.
- Доступ закрыт — проверьте, включён ли переключатель подключения, и попробуйте снова через 5 минут.
- Не найдено — указан неверный адрес или объект уже удалён.
- Слишком много обращений — превышено ограничение; подождите и повторите реже.
- Временная ошибка сервиса — сбой на нашей стороне; повторите не ранее чем через 5 минут, а если повторяется — напишите в поддержку.
Цвет слева подсказывает серьёзность: зелёный — всё хорошо, жёлтый — нужно что-то поправить в самой внешней системе, красный — превышен лимит или временный сбой сервиса.
Подсказки
Совет. Эту справку удобно один раз переслать специалисту, который настраивает внешнюю систему, — тогда он сам поймёт, как реагировать на каждый ответ, и вам не придётся ничего расшифровывать.
Про паузу. Если система стала часто получать ответ «слишком много обращений», значит она обращается слишком плотно. Достаточно распределить обращения по времени — отдельно докупать ничего не нужно.
Про доступ. Ответ «доступ закрыт» чаще всего означает, что у подключения выключен переключатель доступа. Включите его в карточке подключения — и обращения снова начнут проходить.
Частые вопросы
Можно ли увеличить допустимое число обращений? Текущего ограничения хватает для обычной работы ресторана, программы учёта или чат-бота. Если вашей системе действительно нужно больше — напишите в поддержку, вопрос рассматривается индивидуально.
Что делать, если постоянно приходит ответ «слишком много обращений»? Это сигнал, что внешняя система обращается слишком часто. Попросите её разработчика распределить обращения равномернее и не отправлять их большими пачками.
Ответ «неверный ключ доступа» — что проверить? Сверьте идентификатор и секретный ключ из карточки подключения с тем, что введено во внешней системе. Если ключ мог попасть посторонним — сгенерируйте новый в карточке подключения, старый сразу перестанет работать.
Приходит «доступ закрыт», хотя всё настроено. Почему? Скорее всего выключен переключатель доступа у этого подключения. Откройте его карточку и включите доступ. Если только что включили — подождите пару минут и повторите.
Меняет ли что-то открытие этой справки? Нет. Страница только показывает информацию — ваши подключения, ключи и настройки остаются нетронутыми.
Эта статья была полезна?