Получить наиболее частых собеседников.
Раздел API: Контакты и частые собеседники
contacts.getTopPeers#973478b6 flags:# correspondents:flags.0?true bots_pm:flags.1?true bots_inline:flags.2?true phone_calls:flags.3?true forward_users:flags.4?true forward_chats:flags.5?true groups:flags.10?true channels:flags.15?true bots_app:flags.16?true offset:int limit:int hash:long = contacts.TopPeers;
| Поле | Тип | Описание |
|---|---|---|
| flags | # | Битовая маска: поле вида flags.N?T присутствует, только если поднят бит N. |
| correspondents | flags.0?true | |
| bots_pm | flags.1?true | |
| bots_inline | flags.2?true | |
| phone_calls | flags.3?true | |
| forward_users | flags.4?true | |
| forward_chats | flags.5?true | |
| groups | flags.10?true | |
| channels | flags.15?true | |
| bots_app | flags.16?true | |
| offset | int | Сколько записей пропустить от начала выборки. |
| limit | int | Сколько записей вернуть максимум. |
| hash | long | Хеш того, что уже есть у клиента. Если совпал, сервер отвечает «не изменилось» и не шлёт данные заново. |
Своих ошибок у этого метода нет: он либо отвечает, либо падает на общих проверках ниже.
| Код | Тип | Что это значит |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
Сессия неизвестна серверу: ключ отозван, устарел или вызов сделан до авторизации. |
| 401 | API_ID_INVALID |
api_id не выдавался или заблокирован. Ключи выдаёт my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
Клиент не сообщил слой или сообщил слой, которого сервер не знает. |
| 420 | FLOOD_WAIT_X |
Слишком часто. Повторить не раньше чем через X секунд — число приходит в тексте ошибки. |
| 500 | INTERNAL |
Ошибка на нашей стороне. Запрос можно повторить; если повторяется — это баг у нас. |