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_product string
mime_type string
строка 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" · required
Тип носителя информации в теле запроса
Параметры пути
Строка версии · обязательный
Строка 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