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