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 = 받은 편지함 업로드 전용입니다. 진정한 "Direct Post" (API로 자막 + 공개 설정을 지정하여 즉시 게시)는
video.publish권한 범위와 Content Posting 감사(audit)를 통과해야 합니다. 현재는 사용할 수 없습니다. 여기서는creator_info//post/publish/video/init/(Direct Post)를 호출하지 마세요. 해당 범위가 필요합니다. PULL_FROM_URL은 TikTok 개발자 앱에서 도메인이 인증된 경우에만 작동합니다. 동영상이 인증된 도메인에 없으면 대신 청크FILE_UPLOAD방식을 사용하세요 (초기화 → PUT 바이트 범위 → 상태).- 감사되지 않은 앱은 속도 제한이 있으며 가시성이
SELF_ONLY로 제한될 수 있습니다.