Consultar status do contêiner
curl --request GET \
--url https://cloud.datafyapi.com.br/ig/{creation_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/ig/{creation_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/ig/{creation_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status_code": "FINISHED",
"status": "FINISHED",
"id": "17900000000000002"
}{
"error": {
"message": "Invalid parameter",
"type": "OAuthException",
"code": 100,
"error_subcode": 2207076,
"error_user_title": "Falha ao baixar a mídia."
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Publicações
Consultar status
Acompanhe o processamento de um contêiner antes de publicar.
GET
/
ig
/
{creation_id}
Consultar status do contêiner
curl --request GET \
--url https://cloud.datafyapi.com.br/ig/{creation_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://cloud.datafyapi.com.br/ig/{creation_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://cloud.datafyapi.com.br/ig/{creation_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"status_code": "FINISHED",
"status": "FINISHED",
"id": "17900000000000002"
}{
"error": {
"message": "Invalid parameter",
"type": "OAuthException",
"code": 100,
"error_subcode": 2207076,
"error_user_title": "Falha ao baixar a mídia."
}
}{
"statusCode": 401,
"message": "Token inválido ou não encontrado."
}Retorna o estado de processamento do contêiner. Consulte o campo
Os campos
status_code.
| Valor | Significado |
|---|---|
FINISHED | Pronto para publicar |
IN_PROGRESS | Ainda processando |
ERROR | Falhou. O contêiner não pode ser publicado |
EXPIRED | Passou do prazo sem ser publicado |
PUBLISHED | Já foi publicado |
Quando consultar
Para imagem, o contêiner costuma nascerFINISHED e a consulta é dispensável.
Para vídeo e reel, a consulta é obrigatória. A criação do contêiner responde antes de a Meta baixar o arquivo, então a falha só aparece aqui.
Consulte em intervalos de alguns segundos até sair de IN_PROGRESS.
Publicar um contêiner com erro
Chamarmedia_publish com um contêiner em ERROR é recusado, e a mensagem explica a causa original:
{
"error": {
"message": "Invalid parameter",
"type": "OAuthException",
"code": 100,
"error_subcode": 2207076,
"error_user_title": "Falha ao baixar a mídia.",
"error_user_msg": "Falha ao baixar a mídia.: The media could not be fetched from the provided URL."
}
}
error_user_title e error_user_msg trazem a descrição em português e são mais úteis que o message.Autorizações
Token do canal do Instagram, gerado no painel da Datafy. Formato: sk_live_xxx.
Parâmetros de caminho
ID do contêiner, devolvido por POST /ig/me/media.
Parâmetros de consulta
Use status_code para acompanhar o processamento.
Resposta
Operação aceita.