Médias TikTok : domaines vérifiés et préfixes d'URL
L'API for Business de TikTok télécharge les médias des publications à partir d'URL : video_url, custom_thumbnail_url et photo_images. Chaque URL doit se trouver sur un domaine ou un préfixe d'URL dont l'application développeur a vérifié la propriété. Un domaine se vérifie avec un enregistrement DNS TXT, un préfixe avec un fichier de signature placé sous ce préfixe, via /business/property/add/ et /business/property/verify/ avec l'app_id et le secret de l'application.
easyCoexistence diffuse vos médias à TikTok depuis son propre préfixe d'URL vérifié : publish_tiktok_post prend un lien HTTPS depuis Claude, ChatGPT ou votre propre code, et diffuse le fichier depuis ce lien lorsque TikTok le télécharge ; votre domaine n'a donc besoin d'aucune vérification.
Depuis cette date, TikTok refuse les URL de vidéos qui ne se trouvent pas sur un domaine ou un préfixe d'URL vérifié.
Depuis cette date, les endpoints de propriété d'URL exigent aussi le secret de l'application développeur.
Valeurs de property_type : 1 pour un domaine, 2 pour un préfixe d'URL.
Valeurs de property_status : pending, verified, et not verified, lorsque la tentative a échoué et doit être recommencée.
Les développeurs qui ont publié des vidéos avant cette date ont vu les domaines de ces URL de vidéos passés automatiquement en vérifiés.
Taille maximale d'image acceptée par /business/comment/image/upload/, en données de formulaire multipart, pour un commentaire ou une réponse.
Quelles URL TikTok télécharge-t-il ?
Chaque champ média des deux endpoints de publication est une URL que TikTok récupère lui-même après avoir accepté l'appel ; le fichier doit donc rester accessible jusqu'à la fin du téléchargement :
video_url: la vidéo, que TikTok recommande de garder valide au moins 30 minutes.custom_thumbnail_url: une image à utiliser comme couverture de la vidéo.photo_images: jusqu'à 35 images pour une publication photo.- Délai : TikTok accorde une heure au téléchargement, puis fait échouer la publication avec
video_pull_failedouphoto_pull_failed.
Quelle est la différence entre un domaine et un préfixe d'URL ?
Ce que vous prouvez posséder, et donc quelles URL comptent comme vérifiées. Un domaine convient aux médias sur un hôte que vous possédez ou contrôlez ; un préfixe convient à un dossier sur un hôte où vous ne pouvez que téléverser des fichiers. Voici les règles de TikTok pour chaque type de propriété :
| 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 |
Comment vérifier une propriété ?
Au moyen de deux appels authentifiés avec l'app_id et le secret de l'application développeur, et non un token de compte, la preuve étant placée entre les deux :
- Ajout : POST /business/property/add/ avec
url_property_meta, contenantproperty_typeet url ; la réponse donne signature, ainsi quefile_namepour un préfixe, avecproperty_status0. - Preuve : placez la signature dans un enregistrement DNS TXT pour un domaine, ou dans un fichier public nommé
file_name, avec une seule extension .txt, sous un préfixe. - Vérification : POST /business/property/verify/ avec le même
url_property_meta;property_status1 signifie vérifiée, et 2 signifie que la tentative a échoué.
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_nameComment lister ou supprimer des propriétés ?
GET /business/property/list/ avec app_id et secret renvoie url_property_info_list, chaque entrée contenant property_type, url, property_status, signature et file_name. Les sous-domaines d'un domaine vérifié comptent comme vérifiés sans appel propre, mais n'apparaissent dans la liste que s'ils ont été ajoutés. POST /business/property/delete/ avec app_id, secret et url_property_meta supprime une propriété que l'application ne possède plus ou ne contrôle plus.
Peut-on téléverser un fichier au lieu d'une URL ?
Pas pour les publications. L'API Accounts ne publie qu'à partir d'URL, brouillons compris, et son unique endpoint de téléversement, /business/comment/image/upload/, accepte une image de commentaire en données de formulaire multipart, au format JPG, JPEG, WebP ou PNG, jusqu'à 5 Mo, et renvoie un image_uri pour un commentaire ou une réponse. Le téléversement par morceaux relève de la Content Posting API sur developers.tiktok.com, une API distincte avec ses propres applications, où le mode de transfert s'appelle FILE_UPLOAD.
Que se passe-t-il avec une URL non vérifiée ?
TikTok refuse d'y publier. La référence de l'API for Business énonce la règle pour les vidéos et les photos, mais ne prévoit aucun code de retour propre à ce cas ; lisez donc le code et le message de la réponse. La Content Posting API sur developers.tiktok.com désigne le même cas par url_ownership_unverified, avec le code HTTP 403. Pour tester l'endpoint vidéo avant qu'une propriété soit vérifiée, TikTok publie une URL de vidéo de test qui ne nécessite aucune vérification :
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Comment easyCoexistence transmet-il vos médias à TikTok ?
Par un préfixe d'URL vérifié qui lui appartient, https://easycoexistence.com/api/social/media/. publish_tiktok_post prend votre lien HTTPS, refuse http:// avant tout envoi, et donne à TikTok un lien sous ce préfixe contenant un token signé qui désigne votre fichier, expire au bout de 6 heures et conserve l'extension de votre fichier. Lorsque TikTok le récupère, easyCoexistence vérifie le token, confirme que votre lien utilise HTTPS sur une adresse publique, et diffuse le fichier directement depuis votre lien, requêtes par plage (range) et redirections comprises, sans le stocker. Si votre lien échoue, TikTok ne peut pas télécharger le fichier et la publication échoue.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Erreurs courantes
- Vérifier un sous-domaine tout en hébergeant les fichiers sur son domaine parent. Une video.example.com vérifiée couvre ses propres sous-domaines, pas example.com lui-même.
- Servir le fichier de signature du préfixe via une redirection. TikTok ne suit pas les redirections pour un préfixe d'URL et traite une réponse 3xx comme invalide.
- Enregistrer le fichier de signature sous le nom name.txt.txt. TikTok attend que le nom de fichier corresponde à file_name, avec une seule extension .txt.
- Supprimer le fichier juste après l'appel de publication. TikTok le télécharge ensuite, pendant une heure au plus, et fait échouer la publication si le lien cesse de fonctionner.
De US$ 9 à US$ 0,75 par connexion et par mois, dégressif à mesure que vous ajoutez des connexions, avec un essai gratuit de 3 jours.
Questions fréquemment posées
Pourquoi TikTok exige-t-il des URL de médias vérifiées ?
TikTok indique que la vérification de la propriété des URL de vidéos l'aide à respecter ses règles sur les contenus protégés par le droit d'auteur et sur la sécurité des utilisateurs.
Un domaine TikTok vérifié couvre-t-il ses sous-domaines ?
Oui. Les sous-domaines d'un domaine vérifié comptent comme vérifiés, bien que /business/property/list/ ne les affiche que s'ils ont été ajoutés.
L'API for Business de TikTok peut-elle publier depuis un lien S3 ou CDN ?
Oui, lorsque le lien se trouve sous un domaine ou un préfixe d'URL vérifié par l'application, par exemple un préfixe sur un bucket ou un chemin CDN que vous contrôlez.
Les publications photo exigent-elles aussi des URL vérifiées ?
Oui. L'endpoint photo de TikTok précise que les publications photo ne peuvent pas être publiées à partir d'URL de photos non vérifiées.
Poursuivre la lecture
Connectez votre premier canal en deux minutes.
Aucune validation de plateforme à attendre. Connectez WhatsApp, Instagram, TikTok ou un autre canal, puis demandez à votre IA de publier, de répondre ou de faire un rapport, et regardez-la travailler.
- 3 jours gratuits
- Résiliable à tout moment
- API officielles uniquement
- Supervisé 24/7
Vérifié le