TikTok 媒体 URL:已验证的域名和 URL 前缀
TikTok 的 API for Business 会从以下 URL 下载帖子媒体:video_url、custom_thumbnail_url 和 photo_images。每个 URL 都必须位于开发者应用已验证所有权的域名或 URL 前缀之下。域名通过 DNS TXT 记录验证,前缀则通过放在其下的签名文件验证,两项都经由 /business/property/add/ 和 /business/property/verify/ 完成,调用时需带上应用的 ID 和密钥。
easyCoexistence 从自有的已验证 URL 前缀向 TikTok 提供您的媒体:publish_tiktok_post 接收来自 Claude、ChatGPT 或您自有代码的 HTTPS 链接,并在 TikTok 下载时从该链接流式传输文件,因此您的域名无需验证。
此后,TikTok 会拒绝不在已验证域名或 URL 前缀上的视频 URL。
此后,URL 属性端点同样需要开发者应用的密钥。
property_type 取值:1 表示域名,2 表示 URL 前缀。
property_status 取值包括 pending、verified 和未验证,未验证表示验证尝试失败,须重新进行。
在此之前已发布视频的开发者,其视频 URL 所在的域名已自动设为已验证。
/business/comment/image/upload/ 接受的最大图片,以 multipart 表单数据提交,用于评论或回复。
TikTok 会下载哪些 URL?
两个发布端点中的每个媒体字段,都是 TikTok 在接受调用后自行抓取的 URL,因此文件须保持可访问,直至下载完成:
video_url:视频,TikTok 建议至少保持 30 分钟有效。custom_thumbnail_url:用作视频封面的图片。photo_images:图文帖子最多 35 张图片。- 超时:TikTok 为下载提供一小时时间,超时后帖子会因
video_pull_failed或photo_pull_failed而失败。
域名与 URL 前缀有何区别?
两者区别在于您证明拥有的范围,以及因此哪些 URL 算作已验证。域名适合您拥有或控制的主机上的媒体,前缀适合您只能上传文件的主机上的某个文件夹。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 进行身份验证,而不是账户令牌,两次调用之间需放置证明文件:
- 添加:POST /business/property/add/,参数为
url_property_meta(包含property_type和 url);响应返回 signature,前缀还会返回file_name,property_status为 0。 - 证明:域名需将签名写入 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,可删除应用不再拥有或控制的属性。
能否上传文件而不是 URL?
帖子不能。Accounts API 只支持通过 URL 发布,包括草稿在内;其唯一的上传端点 /business/comment/image/upload/ 以 multipart 表单数据接收评论图片,支持 JPG、JPEG、WebP 和 PNG 格式,大小不超过 5 MB,并返回用于评论或回复的 image_uri。分块文件上传属于 developers.tiktok.com 上的 Content Posting API,这是一个拥有独立应用的单独 API,其中传输方式称为 FILE_UPLOAD。
未验证的 URL 会怎样?
TikTok 会拒绝从该 URL 发布。API for Business 参考文档说明了视频和图片的这一规则,但没有为此定义专门的返回代码,因此请查看响应中的代码和消息。developers.tiktok.com 上的 Content Posting API 将同一情况称为 url_ownership_unverified,返回 HTTP 403。在任何属性通过验证之前要测试视频端点,TikTok 会发布一个无需验证的测试视频 URL:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4easyCoexistence 如何将您的媒体交给 TikTok?
通过 easyCoexistence 自有的一个已验证 URL 前缀: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 不会为 URL 前缀跟随重定向,并将 3xx 响应视为无效。
- 把签名文件保存为 name.txt.txt。TikTok 要求文件名与 file_name 一致,且扩展名只能是单个 .txt。
- 发布调用后立即删除文件。TikTok 之后会在最多一小时内下载该文件,如果链接失效,帖子将发布失败。
每个连接每月从 US$ 9 降至 US$ 0.75,连接越多价格越低,前 3 天免费。
常见问题
为什么 TikTok 要求媒体 URL 经过验证?
TikTok 表示,验证视频 URL 的所有权有助于其遵守关于版权内容和用户安全的政策。
已验证的 TikTok 域名是否涵盖其子域名?
是的。已验证域名的子域名视为已验证,不过 /business/property/list/ 只会显示被添加过的子域名。
TikTok 的 API for Business 能否从 S3 或 CDN 链接发布?
可以,前提是该链接位于应用已验证的域名或 URL 前缀之下,例如您可控制的存储桶或 CDN 路径上的某个前缀。
图片帖子是否也需要经过验证的 URL?
需要。TikTok 的图片端点明确说明,图片帖子无法从未验证的图片 URL 发布。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间