TikTok 媒體網址:已驗證的網域與網址前綴
TikTok API for Business 會從網址下載貼文媒體:video_url、custom_thumbnail_url 與 photo_images。每個網址必須位於開發者應用程式已驗證擁有權的網域或網址前綴之下。網域以 DNS TXT 記錄驗證,前綴則以放在其下的簽章檔案驗證,透過 /business/property/add/ 與 /business/property/verify/,並帶上應用程式的 ID 與密鑰。
easyCoexistence 透過自身已驗證的網址前綴,把你的媒體提供給 TikTok:publish_tiktok_post 接受來自 Claude、ChatGPT 或你自己程式碼的 HTTPS 連結,並在 TikTok 下載時從該連結串流檔案,因此你的網域無須驗證。
自此起,TikTok 拒絕不在已驗證網域或網址前綴內的影片網址。
自此起,網址資源端點也需要開發者應用程式的密鑰。
property_type 的值:1 代表網域,2 代表網址前綴。
property_status 的值:pending、verified,以及 not verified(因嘗試失敗,須重新嘗試)。
在此之前發布影片的開發者,其影片網址所屬的網域已自動設為已驗證。
/business/comment/image/upload/ 接受的最大圖片,以多部分表單資料格式上載,供留言或回覆使用。
TikTok 會下載哪些網址?
兩個發布端點中的每個媒體欄位,都是 TikTok 在接受呼叫後自行擷取的網址,因此檔案必須在下載完成前保持可以存取:
video_url:影片,TikTok 建議至少保持有效 30 分鐘。custom_thumbnail_url:用作影片封面的圖片。photo_images:相片貼文最多 35 張圖片。- 逾時:TikTok 為下載設定一小時的時限,超時後會以
video_pull_failed或photo_pull_failed令貼文失敗。
網域與網址前綴有何分別?
分別在於你證明擁有的範圍,因此哪些網址會被視為已驗證。網域適合位於你擁有或控制的主機上的媒體;前綴適合你只能上載檔案的主機上的資料夾。以下是 TikTok 針對各資源類型的規則:
| Domain | URL prefix | |
|---|---|---|
| What it is | A site you own, such as example.com or a subdomain | https:// plus a host, a path and a final /, such as https://www.example.com/videos/ |
| Proof | A DNS TXT record holding the signature | A file named file_name, holding the signature, uploaded under the prefix |
| Covers | URLs on the domain and its subdomains | URLs that begin with the prefix |
| Leaves out | The parent: verifying video.example.com leaves example.com unverified | Sibling paths: /folder/user/ leaves /folder/public/ unverified |
| Redirects | Not applicable | Not followed; a prefix answering 3xx is invalid |
如何驗證資源?
透過兩個呼叫完成,兩者都以開發者應用程式的 app_id 與 secret 驗證,而非帳戶的存取權杖,中間放置證明:
- 新增:以
url_property_meta呼叫 POST /business/property/add/,內含property_type與 url;回應會提供 signature,若為前綴則另有file_name,且property_status為 0。 - 證明:網域須把 signature 放入 DNS TXT 記錄;前綴則須放入位於前綴之下、名稱為
file_name且僅有單一 .txt 副檔名的公開檔案。 - 檢查:以相同的
url_property_meta呼叫 POST /business/property/verify/;property_status為 1 代表已驗證,2 代表嘗試失敗。
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
-H 'Content-Type: application/json' \
-d '{
"app_id": "<APP_ID>",
"secret": "<APP_SECRET>",
"url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
}'
# data.url_property_info: url, property_type, property_status (0), signature, file_name如何列出或移除資源?
以 app_id 與 secret 呼叫 GET /business/property/list/,會回傳 url_property_info_list,每項包括 property_type、url、property_status、signature 與 file_name。已驗證網域的子網域無須另行呼叫即視為已驗證,但只有在曾被新增時才會出現在清單中。POST /business/property/delete/ 以 app_id、secret 與 url_property_meta 呼叫,可移除應用程式不再擁有或控制的資源。
可以改為上載檔案而非網址嗎?
貼文不可以。帳戶 API 只會以網址發布,草稿亦然;其唯一的上載端點 /business/comment/image/upload/ 以多部分表單資料接受留言圖片,支援 JPG、JPEG、WebP 或 PNG,大小最高 5 MB,並為留言或回覆回傳 image_uri。分段檔案上載屬於 developers.tiktok.com 上的 Content Posting API,這是擁有獨立應用程式的另一組 API,其傳輸方式稱為 FILE_UPLOAD。
未經驗證的網址會怎樣?
TikTok 會拒絕從該網址發布。API for Business 參考文件說明了影片與相片的規則,但沒有為此訂定專屬的回傳代碼,因此請閱讀回應中的代碼與訊息。developers.tiktok.com 上的 Content Posting API 對相同情況稱為 url_ownership_unverified,並回傳 HTTP 403。若想在任何資源驗證前測試影片端點,TikTok 提供一個無須驗證的測試影片網址:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4easyCoexistence 如何把你的媒體送到 TikTok?
透過它自己已驗證的一個網址前綴:https://easycoexistence.com/api/social/media/。publish_tiktok_post 接受你提供的 HTTPS 連結,在任何資料送出前拒絕 http://,並給 TikTok 一個位於該前綴之下的連結,其中含有指明你檔案的簽署權杖,6 小時後過期,並保留檔案的副檔名。TikTok 擷取該連結時,easyCoexistence 會檢查權杖、確認你的連結使用公開位址上的 HTTPS,並直接從你的連結串流檔案,包括範圍請求與重新導向,且不儲存檔案。若你的連結失敗,TikTok 便無法下載檔案,貼文亦會失敗。
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4常見錯誤
- 驗證了子網域,卻把檔案放在其上層網域。已驗證的 video.example.com 只涵蓋其自身的子網域,不包括 example.com 本身。
- 透過重新導向提供前綴的簽章檔案。TikTok 不會為網址前綴跟隨重新導向,並會把 3xx 回應視為無效。
- 把簽章檔案存為 name.txt.txt。TikTok 要求檔案名稱與 file_name 相符,且只能有單一 .txt 副檔名。
- 在發布呼叫後隨即刪除檔案。TikTok 會在之後最多一小時內下載,若連結失效,貼文便會失敗。
每個連接每月 US$ 9 起,連接越多越便宜,最低降至 US$ 0.75,首 3 天免費試用。
常見問題
為何 TikTok 要求已驗證的媒體網址?
TikTok 表示,驗證影片網址的擁有權有助其遵守有關版權內容與用戶安全的政策。
已驗證的 TikTok 網域會涵蓋其子網域嗎?
會。已驗證網域的子網域亦視為已驗證,不過 /business/property/list/ 只會列出曾被新增的子網域。
TikTok API for Business 可以從 S3 或 CDN 連結發布嗎?
可以,前提是該連結位於應用程式已驗證的網域或網址前綴之下,例如你所控制的儲存桶或 CDN 路徑上的前綴。
相片貼文也需要已驗證的網址嗎?
需要。TikTok 的相片端點聲明,相片貼文不能從未驗證的相片網址發布。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期