Ограничение частоты запросов#
Система предназначена для предотвращения неверного использования API. Запросы выполненные с частотой выше, чем указано в таблице будут отклонены с ошибкой 429. Значения применяются к каждому инстансу.
Пример
Для 10 инстансов, каждый из которых выполняет по 50 запросов SendMessage, вы можете суммарно выполнить 500 запросов без получения ошибки 429.
Если на одном инстансе будет выполнен 51 запрос SendMessage за 1 секунду, то 51-й запрос будет отклонен с ошибкой 429. В это же время остальные инстансы продолжат выполнять запросы без получения ошибок.
Допустимое число запросов#
Для удобства навигации методы в таблице структурированы по группам:
| Метод | Число запросов в секунду |
|---|---|
| Аккаунт | |
| StartAuthorization | 1 |
| SendAuthorizationCode | 1 |
| Logout | 1 |
| GetStateInstance | 1 |
| Reboot | 1 |
| QR | 3 |
| GetSettings | 1 |
| SetSettings | 1 |
| GetAccountSettings | 1 |
| SetProfilePicture | 0.1 |
| Отправка | |
| SendMessage | 50 |
| SendFileByUrl | 50 |
| SendFileByUpload | 50 |
| SendLocation | 50 |
| SendContact | 50 |
| SendPoll | 50 |
| Получение | |
| ReceiveNotification | 100 |
| DeleteNotification | 100 |
| DownloadFile | 5 |
| Журналы | |
| GetChatHistory | 1 |
| GetMessage | 1 |
| LastIncomingMessage | 1 |
| LastOutgoingMessages | 1 |
| Очереди | |
| GetMessagesCount | 1 |
| ShowMessagesQueue | 1 |
| ClearMessagesQueue | 1 |
| GetWebhooksCount | 1 |
| ClearWebhooksQueue | 1 |
| Группы | |
| CreateGroup | 1 |
| UpdateGroupName | 1 |
| GetGroupData | 1 |
| UpdateGroupSettings | 1 |
| AddGroupParticipant | 1 |
| RemoveGroupParticipant | 1 |
| SetGroupAdmin | 1 |
| RemoveAdmin | 1 |
| LeaveGroup | 1 |
| SetGroupPicture | 1 |
| Отметка прочтения | |
| ReadChat | 10 |
| Сервисные методы | |
| CheckAccount | 10 |
| GetChats | 1 |
| GetContacts | 1 |
| GetAvatar | 10 |
| EditMessage | 50 |
| DeleteMessage | 1 |
| SendTyping | 1 |