Перейти к содержанию

GetUploadURL

GetUploadURL(bot, type)

Bases: BaseConnection

Класс для получения URL загрузки файла определённого типа.

https://dev.max.ru/docs-api/methods/POST/uploads

Ограничения сервера MAX на загружаемые файлы (по типам):

Тип Форматы Лимиты
image JPG/JPEG/PNG/GIF/TIFF/BMP/HEIC до 50 МБ, ≤7680×7680 px
video MP4, MOV, MKV, WEBM до 250 МБ
audio MP3, WAV, M4A и др. до 256 МБ, ≤60 мин
file TXT, DOC, PDF и др. до 4 ГБ

Для image и audio оба условия (размер и вторая величина) проверяются одновременно — должны выполняться оба. Актуальные значения в коде — maxapi.utils.upload_limits.UPLOAD_LIMITS.

Библиотека при любой загрузке (upload_media, attachments, upload_file) проверяет только размер и лишь предупреждает в логе при превышении; окончательную проверку выполняет сервер MAX.

Attributes:

Name Type Description
bot

Экземпляр бота для выполнения запроса.
type

Тип загружаемого файла (например, image, video и т.д.).
Source code in maxapi/methods/get_upload_url.py 
44
45
46
47
def __init__(self, bot: "Bot", type: UploadType):
    super().__init__()
    self.bot = bot
    self.type = type

fetch() async

Выполняет POST-запрос для получения URL загрузки файла.

Возвращает объект с данными URL.

Returns:

Name Type Description
GettedUploadUrl GettedUploadUrl

Результат с URL для загрузки.
Source code in maxapi/methods/get_upload_url.py 
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
async def fetch(self) -> GettedUploadUrl:
    """
    Выполняет POST-запрос для получения URL загрузки файла.

    Возвращает объект с данными URL.

    Returns:
        GettedUploadUrl: Результат с URL для загрузки.
    """

    bot = self._ensure_bot()

    params = bot.params.copy()

    params["type"] = self.type.value

    response = await super().request(
        method=HTTPMethod.POST,
        path=ApiPath.UPLOADS,
        model=GettedUploadUrl,
        params=params,
    )

    return cast(GettedUploadUrl, response)