TikTok メディア URL:検証済みドメインと URL プレフィックス
TikTok の API for Business は、video_url、custom_thumbnail_url、photo_images などのメディア URL から投稿用の動画や画像をダウンロードします。各 URL は、開発者のアプリが所有権を検証したドメインまたは URL プレフィックスの配下にある必要があります。ドメインは DNS TXT レコードで、プレフィックスは配下に置いた署名ファイルで検証します。検証には、アプリの app_id と secret を使って /business/property/add/ と /business/property/verify/ を呼び出します。
easyCoexistence は、独自の検証済み URL プレフィックスから TikTok にメディアを配信します。
それ以降、TikTok は検証済みのドメインまたは URL プレフィックスにない動画 URL を受け付けません。
それ以降、URL プロパティのエンドポイントには、開発者アプリの secret も必要です。
property_type の値は、ドメインが 1、URL プレフィックスが 2 です。
property_status の値は pending、verified、そして検証に失敗して再実行が必要な not verified です。
それ以前に動画を公開していた開発者は、その動画 URL のドメインが自動的に検証済みに設定されています。
コメントまたは返信用に、/business/comment/image/upload/ が multipart form data で受け付ける最大画像サイズです。
TikTok はどの URL をダウンロードしますか?
公開用エンドポイントにある各メディアフィールドは、TikTok が呼び出しを受理した後に自分で取得する URL です。そのため、ダウンロードが終わるまでファイルにアクセスできる状態を保つ必要があります。
video_url:動画です。TikTok は、少なくとも 30 分間は有効な状態を保つことを推奨しています。custom_thumbnail_url:動画のカバーに使う画像です。photo_images:写真投稿用の画像で、最大 35 枚です。- タイムアウト:TikTok はダウンロードに 1 時間を与え、その後は
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 で認証する 2 回の呼び出しで行います。その間に証明を配置します:
- 追加:
url_property_metaを付けて 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 が含まれます。検証済みドメインのサブドメインは、個別の呼び出しをしなくても検証済みとして扱われますが、追加されていた場合にのみ一覧に表示されます。app_id、secret、url_property_meta を付けて POST /business/property/delete/ を呼び出すと、アプリがもはや所有または管理していないプロパティを削除できます。
URL ではなくファイルをアップロードできますか?
投稿には使えません。Accounts API は、下書きを含めて URL からのみ公開します。唯一のアップロードエンドポイントである /business/comment/image/upload/ は、コメント用の画像を multipart form data で受け付けます。対応形式は 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 では、同じケースが HTTP 403 とともに url_ownership_unverified と呼ばれます。プロパティを検証する前に動画エンドポイントを試すには、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 はその後最大 1 時間かけてファイルをダウンロードし、リンクが機能しなくなると投稿を失敗させます。
publish_tiktok_post は、Claude、ChatGPT、または独自のコードから HTTPS のリンクを受け取り、TikTok がダウンロードする際にそのリンクからファイルをストリーミングします。そのため、お客様のドメインの検証は不要です。料金は接続 1 件あたり月額 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 から写真投稿を公開できないと記載されています。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日