Pular para o conteúdo
Entrar Lista de espera
Docs/Referência da API/TikTok/Criador no TikTok

Criador no TikTok

GET /v1/tiktok/creator escopo read

O que a conta do TikTok conectada aceita (creator_info: privacidades, duração máxima…). channel escolhe a conta.

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

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

Parâmetros

Nome Onde Descrição
channel consulta Id da conta quando a rede tem várias (de GET /v1/channels). Sem ele, o canal padrão.

Exemplo

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

Resposta

Status de sucesso Quando
200 Sucesso.
Resposta 200
{
  "connected": true,
  "name": "Dev Ocioso",
  "username": "devocioso",
  "avatar": "/v1/channels/tiktok/avatar",
  "privacyLevels": [
    "SELF_ONLY",
    "PUBLIC_TO_EVERYONE"
  ],
  "allowedPrivacyLevels": [
    "SELF_ONLY"
  ],
  "appAudited": false,
  "directAvailable": true,
  "maxDurationSec": 600,
  "commentsDisabled": false,
  "duetDisabled": false,
  "stitchDisabled": false,
  "queriedAt": "2026-11-07T14:02:11.482Z"
}

Enquanto o app não passa na auditoria do TikTok, allowedPrivacyLevels traz só SELF_ONLY. A resposta fica em cache por 60 s.

Exemplo lido do códigoEsta rota não dá para chamar nos testes sem um provedor de verdade (Buffer, vídeo no YouTube, TikTok…), então o exemplo foi montado lendo o código do servidor. As outras respostas saem de chamadas reais ao servidor de testes.

Erros

Sem erros específicos desta rota além dos comuns.

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.