Описание
Этот объект представляет файл, готовый к загрузке. Файл можно скачать по ссылке https://api.telegram.org/file/bot. Гарантируется, что ссылка будет действительна как минимум 1 час. Когда срок действия ссылки истечёт, можно запросить новую, вызвав getFile.
Максимальный размер файла для загрузки — 20 МБ
| Поле | Тип | Описание |
|---|---|---|
| file_id | String | Идентификатор этого файла, который можно использовать для загрузки или повторного использования файла |
| file_unique_id | String | Уникальный идентификатор этого файла, который должен оставаться неизменным с течением времени и для разных ботов. Не может использоваться для загрузки или повторного использования файла. |
| file_size | Integer | Необязательный. Размер файла в байтах. Может быть больше 2^31, и некоторые языки программирования могут испытывать трудности/иметь скрытые дефекты при его интерпретации. Однако он имеет не более 52 значащих битов, поэтому для хранения этого значения безопасно использовать знаковое 64-битное целое число или число двойной точности с плавающей запятой. |
| file_path | String | Необязательный. Путь к файлу. Используйте https://api.telegram.org/file/bot для получения файла. |
Примеры
json
{
"file_id": "AgACAgUAAxkBAAIBR2Yv",
"file_unique_id": "AQADBAADYQADbQADIAE",
"file_size": 535432,
"file_path": "photos/file_123.jpg"
}История изменений
- API 4.5. Обновлен объект File: Добавлено поле file_unique_id
Дополнительно
- getFile - Метод для получения информации о файле и временной ссылки для его скачивания.