Перейти к основному содержимому

WhatsApp Cloud API — API для загрузки медиафайлов | Документация для разработчиков

WhatsApp Cloud API - API для загрузки медиафайлов

Экземпляр для программы магистратуры (LLM)
Версия
Загружайте медиафайлы (изображения, видео, аудио, документы, стикеры) в WhatsApp.
Возвращает идентификатор медиафайла, который можно использовать для отправки медиасообщений.
Поддерживает различные форматы файлов и загрузку данных из нескольких частей форм.

Базовый URLАутентификация

https://graph.facebook.comСхема
Тип
Расположение

Конечные точки


ПОЧТА /{Версия}/{НомерТелефона-ID}/media

Этот запрос загружает изображение в формате .jpeg. Параметры указываются следующим образом: bearerAuthданные формы в запросе тело.

Синтаксис запроса

ПОЧТА /{Версия}/{Номер-телефона-ID}/медиа
Попробуйте!
Выберите язык

curl --request POST \ --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/media' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{ "file": "@/local/path/file.ogg;type=ogg", "messaging_product": "whatsapp" }'
Выберите код состояния

{ "Загрузить аудио (form-data)": { "value": { "id": "<MEDIA_ID> " } }, "Загрузка аудио в формате JSON": { "value": { "id": "4490709327384033" } }, "Загрузка изображения в формате JSON": { "value": { "id": "4490709327384033" } }, "Загрузка файла стикера (form-data)": { "value": { "id": "<MEDIA_ID> " } }, "Загрузить файл стикера в формате JSON": { "value": { "id": "4490709327384033" } } }
Параметры заголовка
Агент пользователянить
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
Авторизациянить·необходимый
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Параметры пути
Версиянить·необходимый
Номер телефона - IDнить·необходимый
Текст запросаНеобязательный
Тип контента: приложение/json
Схема: объект
Показать дочерние атрибуты

файлнить

messaging_productнить
Содержание Тип:
multipart/form-data
Схема: объект
Показать дочерние атрибуты

файлстрока (двоичная)

messaging_productнить
Ответы
Этот запрос загружает изображение в формате .jpeg. Параметры указываются следующим образом: данные формы в запросе тело.
200
Загрузка изображения в формате JSON / Загрузка файла стикера (form-data) / Загрузка файла стикера в формате JSON / Загрузка аудиофайла (form-data) / Загрузка аудиофайла в формате JSON
Тип контента: приложение/json
Схема: объект
Показать дочерние атрибуты

идентификаторнить
Выберите язык

curl --request POST \ --url 'https://graph.facebook.com/{Version}/{Phone-Number-ID}/media' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{ "file": "@/local/path/file.ogg;type=ogg", "messaging_product": "whatsapp" }'
Выберите код состояния

{ "Загрузить аудио (form-data)": { "value": { "id": "<MEDIA_ID> " } }, "Загрузка аудио в формате JSON": { "value": { "id": "4490709327384033" } }, "Загрузка изображения в формате JSON": { "value": { "id": "4490709327384033" } }, "Загрузка файла стикера (form-data)": { "value": { "id": "<MEDIA_ID> " } }, "Загрузить файл стикера в формате JSON": { "value": { "id": "4490709327384033" } } }

Аутентификация

Схема
Тип
Расположение
bearerAuth
HTTP Bearer
Заголовок: Авторизация

Примеры использования

bearerAuth:
Включите Authorization: Bearer your-token-here в заголовки запроса.

Глобальные требования к аутентификации

Для работы всех конечных точек требуется:
bearerAuth