Obter URL da mídia
curl --request GET \
--url https://cloud.datafyapi.com.br/v1/{media_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/v1/{media_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{media_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"messaging_product": "whatsapp",
"url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=1234567890123456&ext=1757960000&hash=ATtAbCdEfGh",
"mime_type": "image/jpeg",
"sha256": "c160fa1bc488af7f48984bd627bc5cbc5a20b98eaaf11af92e99a206b376252d",
"file_size": 36287,
"id": "1234567890123456"
}{
"error": {
"message": "(#100) Invalid parameter",
"type": "OAuthException",
"code": 100,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Mídias
Obter URL da mídia
Consulte os dados de uma mídia pelo ID, como tipo, tamanho e URL de download.
GET
/
v1
/
{media_id}
Obter URL da mídia
curl --request GET \
--url https://cloud.datafyapi.com.br/v1/{media_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/v1/{media_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/v1/{media_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"messaging_product": "whatsapp",
"url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=1234567890123456&ext=1757960000&hash=ATtAbCdEfGh",
"mime_type": "image/jpeg",
"sha256": "c160fa1bc488af7f48984bd627bc5cbc5a20b98eaaf11af92e99a206b376252d",
"file_size": 36287,
"id": "1234567890123456"
}{
"error": {
"message": "(#100) Invalid parameter",
"type": "OAuthException",
"code": 100,
"fbtrace_id": "AbCdEfGhIjK"
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Consulta uma mídia pelo ID, seja ela enviada por você com o Upload de mídia, seja recebida de um cliente pelo webhook. A resposta traz o tipo, o tamanho, o hash e uma URL de download.
Como o token da Meta fica guardado na Datafy e nunca é exposto, baixar o arquivo por essa URL não é possível pela API. Para obter o arquivo, use o endpoint da Datafy Baixar mídia recebida: ele busca a mídia na Meta, guarda o arquivo e devolve uma URL pronta, válida por 30 dias.
{
"messaging_product": "whatsapp",
"url": "https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=1234567890123456&ext=1757960000&hash=ATtAbCdEfGh",
"mime_type": "image/jpeg",
"sha256": "c160fa1bc488af7f48984bd627bc5cbc5a20b98eaaf11af92e99a206b376252d",
"file_size": 36287,
"id": "1234567890123456"
}
A URL não abre sozinha
A
url da resposta aponta para o domínio da Meta, expira em 5 minutos e só funciona com o token da Meta. Ela não abre no navegador nem com o seu token sk_live_xxx: nos dois casos a resposta é 401.| O que você quer | Endpoint |
|---|---|
| Saber o tipo, o tamanho ou o hash da mídia | Obter URL da mídia (esta página) |
| Baixar o arquivo | Baixar mídia recebida |
Prazos
- Mídia enviada por você com o upload fica disponível por 30 dias, se não for apagada antes.
- Mídia recebida de um cliente pelo webhook fica disponível para download por 7 dias.
phone_number_id faz a Meta processar a consulta só quando a mídia pertence àquele número.
Veja mais detalhes na documentação de mídia da Meta.Autorizações
Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.
Parâmetros de caminho
ID da mídia, retornado pelo upload ou recebido no webhook.
Parâmetros de consulta
Opcional. Se informado, a Meta só processa a requisição quando a mídia pertence a esse número.
Resposta
Dados da mídia.