調用 TikTok 內容發布 API,使用 curl + jq。使用者的 OAuth bearer token
存放在 $TIKTOK_TOKEN 中;每次呼叫都需要 Authorization: Bearer $TIKTOK_TOKEN。基礎 URL:https://open.tiktokapis.com/v2。
回應會包裝在 {"data":...,"error":{"code","message","log_id"}} 中 —
error.code == "ok" 表示成功;否則直接顯示 error.message。
401/access_token_invalid 表示需要重新連接 TikTok。
T="https://open.tiktokapis.com/v2"; AUTH="Authorization: Bearer $TIKTOK_TOKEN"
# 個人資料(帳號卡片)
curl -sS -H "$AUTH" "$T/user/info/?fields=open_id,display_name,avatar_url" \
| jq '.data.user'
將影片上傳到使用者的收件匣 / 草稿(v1)
最簡單的方法是 PULL_FROM_URL:TikTok 從一個已驗證網域上的公開 URL 獲取影片
(AceData 的 cdn.acedata.cloud 已對此應用程式完成驗證)。
VIDEO_URL="https://cdn.acedata.cloud/...mp4" # 必須位於已驗證的網域
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}'
這會將影片放入使用者的 TikTok 收件匣 — 使用者需要打開 TikTok 應用程式 來添加標題、音效、隱私設定並發布。查詢發布狀態:
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}'
注意事項
- v1 僅限收件匣上傳。 真正的「直接發布」(透過 API 設定標題和隱私,
立即發布)需要
video.publish權限範圍並通過內容發布審核 — 在此之前無法使用。此處請勿呼叫creator_info//post/publish/video/init/(直接發布);它們需要該權限範圍。 PULL_FROM_URL僅能從 TikTok 開發者應用程式中已驗證的網域運作。 如果影片不在已驗證的網域上,請改用分段FILE_UPLOAD流程 (初始化 → PUT 位元組範圍 → 查詢狀態)。- 未審核的應用程式會受到速率限制,且可能將可見性限制為
SELF_ONLY。