Documentação da API POST CONECT

Modelo de autorização

Aplicativo web autenticado por sessão por usuário, autorização TikTok OAuth e acesso somente às contas do próprio titular. As chamadas externas só funcionam com tokens e escopos aprovados. A API B2B baseada em chaves individuais ainda não foi habilitada: depende de autorização contratual e controles por cliente.

Recursos locais disponíveis

• GET /health — integridade do serviço
• GET /v1/accounts — contas autorizadas do usuário logado
• GET /v1/oauth/tiktok/start — inicia autorização OAuth, quando credenciais estiverem configuradas
• GET /v1/tiktok/creator-info?account_id=... — opções reais de privacidade e interações, após OAuth
• GET /v1/tiktok/videos?account_id=... — vídeos/métricas conforme escopo
• POST /v1/posts/preflight — valida direitos, consentimento, privacidade e agendamento
• POST /v1/posts — guarda solicitação de publicação para revisão; envio externo desativado
• GET /v1/posts — acompanhamento dos agendamentos do usuário
• POST /v1/accounts/disconnect — desconexão de conta
• POST /v1/auth/delete — exclusão local dos dados e sessão do usuário

As mutações exigem sessão autenticada e token CSRF. A versão atual ainda não concede chaves API a clientes externos.

Exemplo de solicitação de agendamento

{
  "provider": "tiktok",
  "account_id": "tt_conta_autorizada",
  "media_url": "https://midia.dominio-verificado.com/video.mp4",
  "caption": "Vídeo original da minha empresa",
  "privacy_level": "SELF_ONLY",
  "allow_comment": false,
  "allow_duet": false,
  "allow_stitch": false,
  "commercial_disclosure": "none",
  "license_evidence": "Registro da licença ou prova de autoria",
  "duration_seconds": 65,
  "consent": true,
  "scheduled_for": "2026-11-02T12:00:00-03:00",
  "idempotency_key": "pedido-789"
}

Este exemplo é ilustrativo e usa domínios e identificadores fictícios. A conta, a mídia, o consentimento e a privacidade devem ser validados no fluxo real.

TikTok Shop

Dependente de aprovação

Está previsto o uso de permissões de criador e de vendedor distintas, vinculação de produtos via identificador da loja, pré-verificação e métricas comerciais. Não é possível enviar um link arbitrário da Kiwify como sacolinha TikTok Shop. A versão atual não publica vídeos comerciais via TikTok Shop.

Limitações e segurança

O serviço respeita as cotas do TikTok, bloqueia publicações sem direitos comerciais demonstrados e não fornece acesso a tokens de outras pessoas. Um agendamento salvo não significa vídeo publicado. Falhas de confirmação remota não autorizam reenvio duplicado.