Gerar handle de arquivo
curl --request POST \
--url https://cloud.datafyapi.com.br/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/oferta.jpg"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/oferta.jpg'})
};
fetch('https://cloud.datafyapi.com.br/uploads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/uploads"
payload = { "url": "https://exemplo.com/oferta.jpg" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"handle": "4::aW1hZ2UvanBlZw==:ARb..."
}{
"statusCode": 400,
"message": "Campo \"url\" obrigatório"
}{
"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": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Endpoints Datafy
Gerar handle de arquivo
Recebe a URL pública de um arquivo, faz o upload na Meta e retorna o handle dele, exigido em recursos como o cabeçalho de mídia de um template.
POST
/
uploads
Gerar handle de arquivo
curl --request POST \
--url https://cloud.datafyapi.com.br/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"url": "https://exemplo.com/oferta.jpg"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({url: 'https://exemplo.com/oferta.jpg'})
};
fetch('https://cloud.datafyapi.com.br/uploads', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/uploads"
payload = { "url": "https://exemplo.com/oferta.jpg" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"handle": "4::aW1hZ2UvanBlZw==:ARb..."
}{
"statusCode": 400,
"message": "Campo \"url\" obrigatório"
}{
"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": 429,
"message": "Rate limit excedido (60 req/min). Tente novamente em 12s."
}Alguns recursos da Meta não aceitam a URL de um arquivo: eles exigem um
O handle não se restringe a templates. Outros recursos da Meta utilizam o mesmo identificador: a foto de perfil do WhatsApp Business, por exemplo, é atualizada pelo campo
handle, que é o identificador do arquivo depois de enviado para os servidores dela. Gerar esse handle na Meta é um upload em várias etapas — abrir uma sessão, enviar os bytes e ler o identificador de volta.
Com a Datafy, basta enviar a URL pública do arquivo:
{ "handle": "4::aW1hZ2UvanBlZw==:ARb..." }
Onde o handle é usado
O caso mais comum é o cabeçalho de mídia de um template. Ao criar o template, o handle vai emexample.header_handle:
{
"type": "HEADER",
"format": "IMAGE",
"example": { "header_handle": ["4::aW1hZ2UvanBlZw==:ARb..."] }
}
profile_picture_handle. Este endpoint gera o valor em qualquer um desses casos.
O arquivo precisa estar em uma URL pública, acessível sem login. O tipo é lido do próprio arquivo, então respeite os formatos e tamanhos aceitos pela Meta em cada recurso.