Получение URL для загрузки файла

POST/uploads

Возвращает URL для последующей загрузки файла.

Поддерживаются два типа загрузки:

Multipart upload — более простой, но менее надежный способ. В этом случае используется заголовок Content-Type: multipart/form-data. Этот способ имеет ограничения:
- Максимальный размер файла: 4 ГБ
- Можно загружать только один файл за раз
- Невозможно перезапустить загрузку, если она была остановлена
Resumable upload — более надежный способ, если заголовок Content-Type не равен multipart/form-data. Этот способ позволяет загружать файл частями и возобновить загрузку с последней успешно загруженной части в случае ошибок.

Пример использования cURL для загрузки файла:

SHELL

Скопировать

curl -i -X POST \
  -H "Content-Type: multipart/form-data" \
  -F "data=@movie.mp4" "%UPLOAD_URL%"

Где %UPLOAD_URL% - это URL из результата метода в примере cURL запроса

Авторизация

access_token
apiKey optional

Токен присваивается боту при регистрации в MAX через @MasterBot. Это уникальный идентификатор, с помощью которого бот взаимодействует с MAX Bot API: токен передаётся в качестве параметра access_token в HTTP-запросе

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом. Если вы опасаетесь, что идентификатор скомпрометирован, отзовите его и сгенерируйте новый через /revoke в @MasterBot. Токен также может быть отозван за нарушение Правил платформы

Параметры

type
enum UploadType

Enum: "image" "video" "audio" "file"

Тип загружаемого файла

Результат

url
string

URL для загрузки файла