Получить документ по его хешу SHA-256. В основном используется для GIF-анимаций.
Раздел API: Файлы
messages.getDocumentByHash#b1f2061f sha256:bytes size:long mime_type:string = Document;
| Поле | Тип | Описание |
|---|---|---|
| sha256 | bytes | |
| size | long | Размер в байтах. |
| mime_type | string | Тип содержимого файла. |
Своих ошибок у этого метода нет: он либо отвечает, либо падает на общих проверках ниже.
| Код | Тип | Что это значит |
|---|---|---|
| 401 | AUTH_KEY_UNREGISTERED |
Сессия неизвестна серверу: ключ отозван, устарел или вызов сделан до авторизации. |
| 401 | API_ID_INVALID |
api_id не выдавался или заблокирован. Ключи выдаёт my.ansible.su. |
| 400 | CONNECTION_LAYER_INVALID |
Клиент не сообщил слой или сообщил слой, которого сервер не знает. |
| 420 | FLOOD_WAIT_X |
Слишком часто. Повторить не раньше чем через X секунд — число приходит в тексте ошибки. |
| 500 | INTERNAL |
Ошибка на нашей стороне. Запрос можно повторить; если повторяется — это баг у нас. |