TikTok Content Posting API を curl + jq で呼び出します。ユーザーの OAuth Bearer トークンは $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 から動画を取得しますが、その 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スコープと Content Posting 監査の通過が必要です — 現時点では利用できません。ここではcreator_info//post/publish/video/init/(直接投稿)を呼び出さないでください。これらのスコープが必要です。 PULL_FROM_URLは TikTok デベロッパーアプリで確認済みのドメインからのみ機能します。動画が確認済みドメイン上にない場合は、代わりにチャンクアップロードFILE_UPLOADフロー(init → PUT バイトレンジ → ステータス)を使用してください。- 未監査のアプリはレート制限の対象であり、可視性が
SELF_ONLYに制限される場合があります。