Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/Insights/Importar métricas

Importar métricas

POST /v1/insights/import escopo admin

Importa o histórico do YouTube, do Buffer (Instagram) e do TikTok (todas as contas conectadas; channel junto com network limita a uma).

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

Alias antigo em português (continua respondendo, marcado como obsoleto): /v1/insights/importar.

Parâmetros

Nome Onde Descrição
network consulta Limita a uma rede (all importa todas). Valores: all, youtube, instagram, tiktok.
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.
Idempotency-Key cabeçalho Chave de idempotência (1 a 255 caracteres visíveis, por exemplo um UUID). Repetir o MESMO pedido com a mesma chave, em até 24 h, devolve a resposta guardada (com Idempotent-Replayed: true) sem executar de novo; outro pedido com a mesma chave dá 422 idempotency_key_reuse; um pedido ainda em andamento dá 409 idempotency_in_progress. Erros 5xx não são guardados. A chave vale por workspace e por rota. Veja Repetir uma requisição.

Exemplo

curl -X POST "https://praeko.app/v1/insights/import" \
  -H "Authorization: Bearer $PRAEKO_KEY" \
  -H "X-Praeko-Contract: en"

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "imported": [
    {
      "network": "youtube",
      "simulated": false,
      "found": 42,
      "publicCount": 40,
      "created": 38,
      "updated": 2,
      "skippedCount": 0,
      "pages": 1,
      "views": 51230,
      "likes": 3120,
      "comments": 410
    }
  ]
}

Um item por rede importada. Com dryRun/simulated: true nada é gravado.

Erros

Status code Quando
422 idempotency_key_reuse A Idempotency-Key já foi usada com outro pedido (método, caminho, query ou corpo diferentes).
409 idempotency_in_progress Um pedido com a mesma Idempotency-Key ainda está em andamento (repita em instantes).
409 idempotency_response_too_large A resposta original passou de 256 KB e não foi guardada; consulte o recurso por GET.

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.