Правила работы с облаком платформы «Агредатор»
Наша облачная платформа проста и удобна в использовании, но требует соблюдения некоторых правил и ограничений (квот).
Зачем нужны ограничения
Ограничения позволяют платформе «Агредатор» гарантировать стабильность работы сервиса: новые пользователи не могут занять слишком много ресурсов и оказывать влияние на остальных клиентов. Если базовые квоты для вас являются недостаточными, то их можно изменить, обратившись в техническую поддержку.
Правила работы с HTTP API
Если вы выбрали Pull модель взаимодействия, описанную в общих принципах работы, следует учитывать, что частота опроса API может различаться в зависимости от сервиса, к которому выполняется запрос. Нормой является от 1 до 5 проверочных запросов на каждое инициирующее обращение. При превышении этого соотношения вхолостую расходуются вычислительные мощности, нагружается API, а при значительном превышении Вы можете попасть под блокировку доступа.
Коды состояния HTTP
Облачная платформа использует стандартные значения кодов состояния HTTP, отдельно следует отметить некоторые из них:
| Код состояния | Описание |
|---|---|
| 429 | Превышен лимит обращений к API. Следует уменьшить частоту обращений. |
| 404 | Запрашиваемый ресурс (обычно запрос) не найден. Следует прекратить опросы по данному идентификатору или обратиться в техническую поддержку для выяснения причин. |
| 422 | Неверные учётные данные. Следует прекратить обращения к API и обратиться в техническую поддержку для выяснения причин. |
| 400 | Доступ учётной записи к ресурсу заблокирован. Следует прекратить обращения к API и обратиться в техническую поддержку для выяснения причин. |
Частые ображения к API, заканчивающиеся указанными выше кодами, могут быть причиной блокировки доступа.
При работе с API в продуктовом режиме данным кодам следует уделять особое внимание. Кроме того, все ошибки, возникающие в процессе работы, сопровождаются JSON-ответом с подробной расшифровкой кода и причины ошибки.
Само API подробно описано в разделе HTTP-шлюз
Ограничения по умолчанию для сервисов платформы
HTTP API
| Вид ограничения | Значение |
|---|---|
| Число обращений к API | 50 запросов/с |
При превышении установленного лимита в ответе будет получен код состояния HTTP 429
Блокировка доступа
Если действия пользователя будут наносить ущерб и/или вызовут сбой технических и программных средств, то пользователь будет заблокирован до момента устранения оснований приостановления.
К действиям, наносящим ущерб, относятся DDoS-атаки, недобросовестное использование API и отправка некорректных запросов.
При этом клиент будет уведомлён о блокировке в чате техподдержки и в детализации ошибки в теле ответа. Все мероприятия по разблокировке (после устранения причин) будут проводиться службой технической поддержки совместно с пользователем.