Baixar mídia recebida
curl --request GET \
--url https://cloud.datafyapi.com.br/media/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/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/media/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"url": "https://midia.datafyapi.com.br/cli_123/2026/09/1757862000000-a1b2c3d4.jpg",
"mime_type": "image/jpeg",
"size": 184233
}{
"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 mídia recebida
Baixa a mídia recebida pelo webhook e retorna uma URL de download válida por 30 dias.
GET
/
media
/
{id}
Baixar mídia recebida
curl --request GET \
--url https://cloud.datafyapi.com.br/media/{id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/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/media/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"url": "https://midia.datafyapi.com.br/cli_123/2026/09/1757862000000-a1b2c3d4.jpg",
"mime_type": "image/jpeg",
"size": 184233
}{
"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."
}Quando o cliente envia uma imagem, áudio, vídeo ou documento, o webhook traz apenas o ID da mídia, como em
Se em vez do link você quer o arquivo em si, use Baixar o arquivo da mídia.
image.id. Na Meta, transformar esse ID em arquivo exige duas chamadas autenticadas, e o link gerado expira em poucos minutos.
Este endpoint faz esse trabalho por você: baixa o arquivo da Meta e retorna uma URL de download válida por 30 dias, junto com o tipo e o tamanho do arquivo.
curl https://cloud.datafyapi.com.br/media/1234567890123456 \
-H 'Authorization: Bearer sk_live_xxx'
A Meta mantém as mídias recebidas por até 30 dias. Depois disso, ou com um ID inválido, a resposta é 404.
Autorizações
Token gerado no painel da Datafy ao criar o canal. Formato: sk_live_xxx.
Parâmetros de caminho
ID da mídia recebido no webhook, como image.id ou document.id.