Chame a API de Postagem de Conteúdo do TikTok com curl + jq. O token OAuth do usuário está em $TIKTOK_TOKEN; toda chamada precisa de Authorization: Bearer $TIKTOK_TOKEN. URL base: https://open.tiktokapis.com/v2.
As respostas encapsulam tudo em {"data":...,"error":{"code","message","log_id"}} — error.code == "ok" significa sucesso; caso contrário, mostre error.message na íntegra. 401/access_token_invalid = reconectar ao TikTok.
T="https://open.tiktokapis.com/v2"; AUTH="Authorization: Bearer $TIKTOK_TOKEN"
# Perfil (cartão da conta)
curl -sS -H "$AUTH" "$T/user/info/?fields=open_id,display_name,avatar_url" \
| jq '.data.user'
Enviar um vídeo para a caixa de entrada / rascunhos do usuário (v1)
O caminho mais simples é PULL_FROM_URL: o TikTok busca o vídeo de uma URL pública em um domínio verificado (cdn.acedata.cloud da AceData é verificado para este aplicativo).
VIDEO_URL="https://cdn.acedata.cloud/...mp4" # deve estar em um domínio verificado
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" -d "$(jq -n --arg u "$VIDEO_URL" \
'{source_info:{source:"PULL_FROM_URL", video_url:$u}}')" \
"$T/post/publish/inbox/video/init/" | jq '{publish_id: .data.publish_id, error}'
Isso coloca o vídeo na caixa de entrada do TikTok do usuário — ele abre o aplicativo TikTok para adicionar legenda / som / privacidade e postar. Consulte o status:
curl -sS -X POST -H "$AUTH" -H "Content-Type: application/json" \
-d '{"publish_id":"PUBLISH_ID"}' "$T/post/publish/status/fetch/" \
| jq '.data | {status, fail_reason}'
Armadilhas
- v1 = upload apenas para a caixa de entrada. A verdadeira "Postagem Direta" (definir legenda + privacidade via API, posta imediatamente) precisa do escopo
video.publishe de uma auditoria aprovada de Postagem de Conteúdo — indisponível até lá. Não chamecreator_info//post/publish/video/init/(Postagem Direta) aqui; eles exigem esse escopo. PULL_FROM_URLsó funciona a partir de um domínio verificado no aplicativo de desenvolvedor TikTok. Se o vídeo não estiver em um domínio verificado, use o fluxoFILE_UPLOADem partes (init → PUT intervalos de bytes → status).- Aplicativos não auditados têm limite de taxa e podem restringir a visibilidade para
SELF_ONLY.