调用 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 从 已验证域名(本应用的 cdn.acedata.cloud 已验证)上的公共 URL 拉取视频。
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。