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

WhatsApp Cloud API - Media API | Документация для разработчиков

WhatsApp Cloud API - Медиа API

Экземпляр для программы магистратуры (LLM)
Версия
Извлекать и удалять загруженные медиафайлы по идентификатору медиафайла.
Получите URL-адреса медиафайлов с метаданными, включая размер, MIME-тип и хеш SHA256.
Ссылки на медиафайлы действительны в течение 5 минут после загрузки.

База

URL
https://graph.facebook.com

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

ПОЛУЧАТЬ /{Версия}/{Идентификатор носителя}

Чтобы получить URL-адрес вашего медиафайла, создайте.. ПОЛУЧАТЬ призыв к /{{Media-ID}}Используйте полученный URL-адрес для загрузки медиафайла. Обратите внимание, что нажатие на этот URL-адрес (т.е. выполнение стандартного запроса GET) не вернет медиафайл; необходимо указать токен доступа. Для получения дополнительной информации см Скачать медиафайлы.
Вы также можете использовать необязательный запрос ?phone_number_id для Получить URL медиафайла и Удалить медиафайлыЭтот параметр проверяет, принадлежит ли медиафайл номеру телефона, прежде чем его можно будет получить или удалить.
Ответ
Успешный ответ включает объект с URL-адресом медиафайла. URL-адрес действителен только в течение 5 минут. Чтобы использовать этот URL-адрес, см Скачать медиафайлы.

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

ПОЛУЧАТЬ /{Версия}/{Media-ID}
Попробуйте!
Выберите язык
curl --request GET \ --url 'https://graph.facebook.com/{Version}/{Media-ID}' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{}'
Выберите код состояния
{ "Получить URL медиафайла": { "value": { "file_size": "303833", "id": "2621233374848975", "messaging_product": "whatsapp", "mime_type": "image/jpeg", "sha256": "<HASH> ", "url": "<URL> " } } }
Параметры заголовка
Агент пользователянить
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
Авторизациянить·необходимый
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Параметры пути
Версиянить·необходимый
Media-IDнить·необходимый
Параметры запроса
номер_телефона_идентификаторнить
Указывает, что это действие будет выполнено только в том случае, если носитель информации принадлежит указанному номеру телефона.
Ответы
Чтобы получить URL-адрес вашего медиафайла, создайте.. ПОЛУЧАТЬ призыв к /{{Media-ID}}Используйте полученный URL-адрес для загрузки медиафайла. Обратите внимание, что нажатие на этот URL-адрес (т.е. выполнение стандартного запроса GET) не вернет медиафайл; необходимо указать токен доступа. Для получения дополнительной информации см Скачать медиафайлы.
Вы также можете использовать необязательный запрос ?phone_number_id для Получить URL медиафайла и Удалить медиафайлыЭтот параметр проверяет, принадлежит ли медиафайл номеру телефона, прежде чем его можно будет получить или удалить.
Ответ
Успешный ответ включает объект с URL-адресом медиафайла. URL-адрес действителен только в течение 5 минут. Чтобы использовать этот URL-адрес, см Скачать медиафайлы.
200
Получить URL медиафайла
Тип контента: приложение/json
Схема: объект
Показать дочерние атрибуты
размер файланить
идентификаторнить
messaging_productнить
mime_typeнить
sha256нить
urlнить
Выбирать язык
curl --request GET \ --url 'https://graph.facebook.com/{Version}/{Media-ID}' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{}'
Выберите код состояния
{ "Получить URL медиафайла": { "value": { "file_size": "303833", "id": "2621233374848975", "messaging_product": "whatsapp", "mime_type": "image/jpeg", "sha256": "<HASH> ", "url": "<URL> " } } }

УДАИТЬ /{Версия}/{Идентификатор носителя}

Для удаления медиафайлов выполните DELETE к идентификатору файла, который вы хотите удалить.

Предварительные требования

Токен доступа пользователя с разрешением whatsapp_business_messaging
Идентификатор медиаобъекта из конечной точки загрузки медиафайлов или веб-хуков сообщений о медиафайлах

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

УДАЛИТЬ /{Версия}/{Media-ID}
Попробуйте!
Выберите язык
curl --request DELETE \ --url 'https://graph.facebook.com/{Version}/{Media-ID}' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{}'
Выберите код состояния
{ "Удалить медиафайлы": { "значение": { "успех": true } } }
Параметры заголовка
Агент пользователянить
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
Авторизациянить·необходимый
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Content-TypeОдин из "application/json", "application/x-www-form-urlencoded", "multipart/form-data"·необходимый
Тип носителя информации в теле запроса
Параметры пути
Версиянить·необходимый
Media-IDнить·необходимый
Параметры запроса
номер_телефона_идентификаторнить
Указывает, что удаление медиафайла должно быть выполнено только в том случае, если медиафайл принадлежит указанному номеру телефона.
Ответы
Для удаления медиафайлов выполните DELETE к идентификатору файла, который вы хотите удалить.

Предварительные требования

Токен доступа пользователя с разрешением whatsapp_business_messaging
Идентификатор медиаобъекта из конечной точки загрузки медиафайлов или веб-хуков сообщений о медиафайлах
200
Удалить медиафайлы
Тип содержимого: application/json
Схема: объект
Показать дочерние атрибуты
успех логическое значение
Выберите язык
curl --request DELETE \ --url 'https://graph.facebook.com/{Version}/{Media-ID}' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{}'
Выберите код состояния
{ "Удалить медиафайлы": { "значение": { "успех": true } } }

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

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

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

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

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

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