mirror of
https://github.com/aiogram/aiogram.git
synced 2025-12-08 17:13:56 +00:00
1.4 KiB
1.4 KiB
getFile
Description
Use this method to get basic info about a file and prepare it for downloading. For the moment, bots can download files of up to 20MB in size. On success, a File object is returned. The file can then be downloaded via the link https://api.telegram.org/file/bot/<file_path>, where <file_path> is taken from the response. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by calling getFile again.
Note: This function may not preserve the original file name and MIME type. You should save the file's MIME type and name (if available) when the File object is received.
Arguments
| Name | Type | Description |
|---|---|---|
file_id |
#!python3 str |
File identifier to get info about |
Response
Type: #!python3 File
Description: On success, a File object is returned.
Usage
As bot method bot
result: File = await bot.get_file(...)
Method as object
Imports:
from aiogram.methods import GetFilefrom aiogram.api.methods import GetFilefrom aiogram.api.methods.get_file import GetFile
In handlers with current bot
result: File = await GetFile(...)
With specific bot
result: File = await bot(GetFile(...))