Baixar o arquivo da mídia
curl --request GET \
--url https://cloud.datafyapi.com.br/media/{id}/download \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/media/{id}/download', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/media/{id}/download"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)"<string>"{
"statusCode": 400,
"message": "Falha ao baixar a mídia da Meta (403)"
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}{
"statusCode": 402,
"message": "Assinatura inativa. Ative sua assinatura no painel para voltar a usar a API."
}{
"statusCode": 404,
"message": "Mídia não encontrada ou expirada (ID inválido ou mais de 30 dias)"
}{
"statusCode": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Endpoints Datafy
Baixar o arquivo da mídia
Retorna o arquivo da mídia recebida pelo webhook, em bytes, em vez de uma URL.
GET
/
media
/
{id}
/
download
Baixar o arquivo da mídia
curl --request GET \
--url https://cloud.datafyapi.com.br/media/{id}/download \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/media/{id}/download', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/media/{id}/download"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)"<string>"{
"statusCode": 400,
"message": "Falha ao baixar a mídia da Meta (403)"
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}{
"statusCode": 402,
"message": "Assinatura inativa. Ative sua assinatura no painel para voltar a usar a API."
}{
"statusCode": 404,
"message": "Mídia não encontrada ou expirada (ID inválido ou mais de 30 dias)"
}{
"statusCode": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Este endpoint entrega o arquivo em si, em bytes, em vez de uma URL. Use quando o seu sistema vai guardar a mídia no seu próprio storage, anexar a um atendimento ou processar o conteúdo — sem precisar de um segundo download.
É a alternativa a Baixar mídia recebida, que devolve um link. As duas partem do mesmo
A resposta traz o
id que chega no webhook.
curl https://cloud.datafyapi.com.br/media/1234567890123456/download \
-H 'Authorization: Bearer sk_live_xxx' \
-o arquivo.jpg
Content-Type do arquivo e um Content-Disposition com o nome sugerido, como 1234567890123456.jpg.
Qual dos dois usar
| Endpoint | O que devolve | Quando usar |
|---|---|---|
GET /media/{id} | URL válida por 30 dias | Exibir a mídia numa tela, enviar o link para outro sistema |
GET /media/{id}/download | O arquivo, em bytes | Guardar no seu storage ou processar o conteúdo |
A URL retornada pela Meta não pode ser acessada diretamente: exige o token da Meta no cabeçalho e expira em 5 minutos. O download é feito pela Datafy, com o token da sua conta.
Chamadas repetidas
A primeira chamada busca o arquivo na Meta e o guarda. As seguintes entregam a cópia guardada, sem consumir o limite de requisições da Meta. O cabeçalhox-datafy-cache mostra o que aconteceu: MISS na primeira, HIT nas repetições.
A Meta mantém as mídias recebidas por até 30 dias. Depois disso, ou com um ID inválido, a resposta é 404.