WhatsApp Cloud API - Media API | Документация для разработчиков
WhatsApp Cloud API - Медиа API
Экземпляр для программы магистратуры (LLM)
Версия
Извлекать и удалять загруженные медиафайлы по идентификатору медиафайла.
Получите URL-адреса медиафайлов с метаданными, включая размер, MIME-тип и хеш SHA256.
Ссылки на медиафайлы действительны в течение 5 минут после загрузки.
Базовый URL
https://graph.facebook.com |
Конечные точки
GET /{Version}/{Media-ID}
Чтобы получить URL-адрес вашего медиафайла, выполните GET- запрос к
/{{Media-ID}}. Используйте полученный URL-адрес для загрузки медиафайла. Обратите внимание, что нажатие на этот URL-адрес (т.е. выполнение обычного GET-запроса) не вернет медиафайл; необходимо указать токен доступа. Для получения дополнительной информации см. раздел «Загрузка медиафайлов».Также можно использовать необязательный запрос
?phone_number_id для получения URL-адреса медиафайла и удаления медиафайла. Этот параметр проверяет, принадлежит ли медиафайл номеру телефона, прежде чем его получить или удалить.Ответ
Успешный ответ включает объект с URL-адресом медиафайла. URL-адрес действителен только в течение 5 минут. Чтобы использовать этот URL-адрес, см. раздел «Загрузка медиафайлов».
Синтаксис запроса
GET /{Version}/{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> " } } }Параметры заголовка
User-AgentСтрока
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
авторизацииСтрока·обязательный
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Параметры пути
версииСтрока·обязательный
Media-IDСтрока·обязательный
Параметры запроса
номер_телефона_идентификаторстрока
Указывает, что это действие будет выполнено только в том случае, если носитель информации принадлежит указанному номеру телефона.
Ответы
Чтобы получить URL-адрес вашего медиафайла, выполните GET- запрос к
/{{Media-ID}}. Используйте полученный URL-адрес для загрузки медиафайла. Обратите внимание, что нажатие на этот URL-адрес (т.е. выполнение обычного GET-запроса) не вернет медиафайл; необходимо указать токен доступа. Для получения дополнительной информации см. раздел «Загрузка медиафайлов».Также можно использовать необязательный запрос
?phone_number_id для получения URL-адреса медиафайла и удаления медиафайла. Этот параметр проверяет, принадлежит ли медиафайл номеру телефона, прежде чем его получить или удалить.Ответ
Успешный ответ включает объект с URL-адресом медиафайла. URL-адрес действителен только в течение 5 минут. Чтобы использовать этот URL-адрес, см. раздел «Загрузка медиафайлов».
200
Получить URL медиафайла
Тип содержимого: application/json
Схема: объект
Показать дочерние атрибуты
размера файластрока
идентификаторастрока
messaging_productstring
mime_typestring
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 к идентификатору файла, который вы хотите удалить.
Предварительные требования
Идентификатор медиаобъекта из конечной точки загрузки медиафайлов или веб-хуков сообщений о медиафайлах
Синтаксис запроса
УДАЛИТЬ /{Версия}/{Идентификатор носителя}
Попробуйте!
Выберите язык
curl --request DELETE \ --url 'https://graph.facebook.com/{Version}/{Media-ID}' \ --header 'Authorization: Bearer<Token> ' \ --header 'Content-Type: application/json' \ --data '{}'Выберите код состояния
{ "Удалить медиафайлы": { "значение": { "успех": true } } }Параметры заголовка
User-AgentСтрока
Строка пользовательского агента, идентифицирующая клиентское программное обеспечение, выполняющее запрос.
авторизацииСтрока·обязательный
Токен Bearer для аутентификации API. Это должен быть действительный токен доступа, полученный через соответствующий поток OAuth, или системный пользовательский токен.
Content-TypeОдин из "application/json", "application/x-www-form-urlencoded", "multipart/form-data"·обязательный
Тип носителя информации в теле запроса
Параметры пути
версииСтрока·обязательный
Media-IDСтрока·обязательный
Параметры запроса
номер_телефона_идентификаторстрока
Указывает, что удаление медиафайла должно быть выполнено только в том случае, если медиафайл принадлежит указанному номеру телефона.
Ответы
Для удаления медиафайлов выполните DELETE к идентификатору файла, который вы хотите удалить.
Предварительные требования
Идентификатор медиаобъекта из конечной точки загрузки медиафайлов или веб-хуков сообщений о медиафайлах
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