Rufen Sie die TikTok Content Posting API mit curl + jq auf. Das OAuth-Bearer-Token des Benutzers
befindet sich in $TIKTOK_TOKEN; jeder Aufruf benötigt Authorization: Bearer $TIKTOK_TOKEN. Basis-URL: https://open.tiktokapis.com/v2.
Antworten verpacken alles in {"data":...,"error":{"code","message","log_id"}} —
error.code == "ok" bedeutet Erfolg; andernfalls geben Sie error.message wörtlich aus.
401/access_token_invalid = TikTok neu verbinden.
T="https://open.tiktokapis.com/v2"; AUTH="Authorization: Bearer $TIKTOK_TOKEN"
# Profil (Account-Karte)
curl -sS -H "$AUTH" "$T/user/info/?fields=open_id,display_name,avatar_url" \
| jq '.data.user'
Ein Video in den Posteingang / in die Entwürfe des Benutzers hochladen (v1)
Der einfachste Weg ist PULL_FROM_URL: TikTok ruft das Video von einer öffentlichen URL
auf einer verifizierten Domain ab (AceDatas cdn.acedata.cloud ist für diese App verifiziert).
VIDEO_URL="https://cdn.acedata.cloud/...mp4" # muss auf einer verifizierten Domain sein
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}'
Dies legt das Video in den TikTok-Posteingang des Benutzers ab – er öffnet die TikTok-App, um Bildunterschrift / Sound / Datenschutz hinzuzufügen und zu veröffentlichen. Status abfragen:
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}'
Fallstricke
- v1 = nur Posteingang-Upload. Echter „Direct Post“ (Bildunterschrift + Datenschutz über API setzen,
sofort veröffentlichen) benötigt den
video.publish-Bereich und eine bestandene Content Posting Prüfung – erst dann verfügbar. Rufen Sie hier nichtcreator_info//post/publish/video/init/(Direct Post) auf; diese erfordern diesen Bereich. PULL_FROM_URLfunktioniert nur von einer verifizierten Domain in der TikTok-Entwickler-App. Wenn das Video nicht auf einer verifizierten Domain liegt, verwenden Sie stattdessen den chunkedFILE_UPLOAD-Ablauf (init → PUT-Byte-Bereiche → Status).- Nicht geprüfte Apps sind ratenbegrenzt und können die Sichtbarkeit auf
SELF_ONLYeinschränken.