Рекомендации по ограничению скорости API Blue
В общем, API Blue не устанавливает жесткие ограничения по скорости для большинства операций. Однако некоторые чувствительные операции имеют конкретные ограничения по скорости, чтобы предотвратить злоупотребления и обеспечить стабильность системы.
Операции с ограничением по скорости
Следующие операции имеют установленные ограничения по скорости:
Операция | Ограничение по скорости | Период | Цель |
---|---|---|---|
signIn |
5 requests | 60 seconds | Предотвращение атак методом подбора |
signInRequest |
3 requests | 120 seconds | Ограничение попыток аутентификации |
createDocument |
5 requests | 60 seconds | Предотвращение спама документов |
sendTestEmail |
5 requests | 60 seconds | Предотвращение злоупотребления электронной почтой |
submitForm |
5 requests | 60 seconds | Предотвращение спама форм |
exportTodos |
1 request | 50 seconds | Ограничение ресурсоемких экспортов |
deleteCompany |
3 requests | 60 seconds | Предотвращение случайных удалений |
deleteCompanyRequest |
3 requests | 60 seconds | Предотвращение случайных удалений |
updateEmail |
3 requests | 60 seconds | Предотвращение злоупотребления изменением электронной почты |
updateEmailRequest |
3 requests | 60 seconds | Предотвращение злоупотребления изменением электронной почты |
verifyAcceptInvitation |
3 requests | 60 seconds | Ограничение попыток верификации |
verifySecurityCode |
3 requests | 60 seconds | Ограничение попыток верификации |
Поведение ограничения по скорости
- На пользователя: Ограничения по скорости применяются к каждому аутентифицированному пользователю
- На IP: Для неаутентифицированных запросов ограничения применяются к IP-адресу
- Без заголовков: Информация об ограничении по скорости не включается в заголовки ответа
Ответ об ошибке
Когда превышается ограничение по скорости, вы получите ошибку GraphQL:
{
"errors": [{
"message": "Rate limit exceeded",
"extensions": {
"code": "RATE_LIMITED"
}
}]
}
Рекомендации по лучшим практикам
- Обработка ошибок ограничения по скорости: Реализуйте правильную обработку ошибок для операций с ограничением по скорости
- Экспоненциальный откат: Используйте экспоненциальный откат при повторной попытке запросов с ограничением по скорости
- Мониторинг использования: Будьте в курсе, какие операции имеют ограничения при создании интеграций
Если у вас есть вопросы по ограничениям по скорости, пожалуйста, свяжитесь с нашей службой поддержки.