Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Conexões/Token do Instagram

Token do Instagram

PUT /v1/connections/instagram/token escopo admin

Guarda o token da API da Meta para o Instagram (cifrado). O token é conferido na Meta antes de gravar.

CabeçalhosAuthorization: Bearer praeko_… e X-Praeko-Contract: en. Sempre envie os dois.

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/conexoes/instagram/token.

Corpo da requisição

JSON. Campos obrigatórios precisam ir; os outros podem ser omitidos. O token do exemplo é só um molde: use o seu. O servidor confere o token na Meta antes de guardar.

Campo Tipo Descrição
token obrigatório texto Token de acesso da API da Meta (Instagram). 20 a 4000 caracteres.
userId obrigatório texto Id numérico da conta do Instagram. Até 40 caracteres.
host (opcional) texto Servidor da Meta. Valores: https://graph.facebook.com, https://graph.instagram.com; padrão: https://graph.facebook.com.
username (opcional) texto Usuário, usado só se a Meta não devolver o nome.
type (opcional) texto Tipo da conta. Padrão: BUSINESS.
Exemplo de corpo
{
  "token": "IGAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "userId": "17841400000000000",
  "host": "https://graph.instagram.com"
}

Exemplo

curl -X PUT "https://praeko.app/v1/connections/instagram/token" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en" \
  -H "Content-Type: application/json" \
  -d '{
  "token": "IGAAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "userId": "17841400000000000",
  "host": "https://graph.instagram.com"
}'

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "connected": true,
  "username": "dev.ocioso",
  "followers": 1842,
  "mediaItems": 37,
  "host": "https://graph.instagram.com"
}

Erros

Status code Quando
400 empty_body O corpo veio vazio.
400 invalid_json O corpo não é um objeto JSON.
413 body_too_large O corpo passa de 1 MB.
422 invalid_field Token, userId ou host inválidos.
502 instagram_error A Meta recusou o token.

Erros de qualquer rota

Status code Quando
401 unauthorized Faltou o cabeçalho Authorization: Bearer ….
401 invalid_api_key A chave não existe.
401 revoked_api_key A chave foi revogada.
401 expired_api_key A chave expirou.
403 forbidden O escopo da chave não basta para esta rota (veja o selo de escopo).
429 rate_limited Passou do limite de requisições por minuto.

O corpo de todo erro é { "error": { "code", "message", "details"? } }. Veja todos os códigos.

Testar

Testar

O teste ao vivo usa a sua chave e a sua conta. Para quem não entrou, fica desligado.

Entre para testar
Dúvida ou erro nesta página? contato@praeko.appVer .md

Digite para buscar páginas, rotas e códigos de erro.