Appelez l'API TikTok Content Posting avec curl + jq. Le jeton d'accès OAuth de l'utilisateur se trouve dans $TIKTOK_TOKEN ; chaque appel nécessite Authorization: Bearer $TIKTOK_TOKEN. URL de base : https://open.tiktokapis.com/v2.
Les réponses encapsulent tout dans {"data":...,"error":{"code","message","log_id"}} —
error.code == "ok" signifie un succès ; sinon, affichez error.message textuellement.
401/access_token_invalid = reconnectez TikTok.
T="https://open.tiktokapis.com/v2"; AUTH="Authorization: Bearer $TIKTOK_TOKEN"
# Profil (carte de compte)
curl -sS -H "$AUTH" "$T/user/info/?fields=open_id,display_name,avatar_url" \
| jq '.data.user'
Télécharger une vidéo dans la boîte de réception / brouillons de l'utilisateur (v1)
La méthode la plus simple est PULL_FROM_URL : TikTok récupère la vidéo depuis une URL publique
sur un domaine vérifié (cdn.acedata.cloud d'AceData est vérifié pour cette application).
VIDEO_URL="https://cdn.acedata.cloud/...mp4" # doit être sur un domaine vérifié
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}'
Ceci place la vidéo dans la boîte de réception TikTok de l'utilisateur — il ouvre l'application TikTok pour ajouter une légende, du son, des paramètres de confidentialité et publier. Vérifiez l'état :
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}'
Pièges à éviter
- v1 = téléchargement dans la boîte de réception uniquement. La véritable "Publication directe" (définition de la légende + paramètres de confidentialité via l'API,
publication immédiate) nécessite l'étendue
video.publishet un audit Content Posting réussi — indisponible pour l'instant. N'appelez pascreator_info//post/publish/video/init/(Publication directe) ici ; ils nécessitent cette étendue. PULL_FROM_URLne fonctionne qu'à partir d'un domaine vérifié dans l'application développeur TikTok. Si la vidéo n'est pas sur un domaine vérifié, utilisez plutôt le fluxFILE_UPLOADpar blocs (init → PUT par plages d'octets → état).- Les applications non auditées sont limitées en débit et peuvent restreindre la visibilité à
SELF_ONLY.