TikTok-Medien-URLs: verifizierte Domains und URL-Präfixe
Die API for Business von TikTok lädt Post-Medien über URLs herunter: video_url, custom_thumbnail_url und photo_images. Jede URL muss auf einer Domain oder einem URL-Präfix liegen, dessen Inhaberschaft die Entwickler-App verifiziert hat. Eine Domain wird über einen DNS-TXT-Eintrag verifiziert, ein Präfix über eine darunter abgelegte Signaturdatei, und zwar über /business/property/add/ und /business/property/verify/ mit App-ID und Secret.
easyCoexistence stellt Ihre Medien TikTok über ein eigenes verifiziertes URL-Präfix bereit: publish_tiktok_post nimmt einen HTTPS-Link von Claude, ChatGPT oder Ihrem eigenen Code entgegen und streamt die Datei von dort, wenn TikTok sie herunterlädt.
Seitdem lehnt TikTok Video-URLs ab, die nicht auf einer verifizierten Domain oder einem verifizierten URL-Präfix liegen.
Seitdem verlangen die URL-Property-Endpoints zusätzlich das Secret der Entwickler-App.
property_type-Werte: 1 für eine Domain, 2 für ein URL-Präfix.
property_status-Werte: pending, verified und not verified, wenn der Versuch fehlgeschlagen ist und wiederholt werden muss.
Entwickler, die davor Videos veröffentlicht haben, wurden für die Domains dieser Video-URLs automatisch als verifiziert gesetzt.
Größtes Bild, das /business/comment/image/upload/ als Multipart-Formulardaten annimmt, für einen Kommentar oder eine Antwort.
Welche URLs lädt TikTok herunter?
Jedes Medienfeld in den beiden Veröffentlichungs-Endpoints ist eine URL, die TikTok nach Annahme des Aufrufs selbst abruft. Die Datei muss deshalb bis zum Ende des Downloads erreichbar bleiben:
video_url: das Video, für das TikTok empfiehlt, die URL mindestens 30 Minuten gültig zu halten.custom_thumbnail_url: ein Bild, das als Titelbild des Videos dient.photo_images: bis zu 35 Bilder für einen Foto-Post.- Timeout: TikTok gibt dem Download eine Stunde, danach schlägt der Post mit
video_pull_failedoderphoto_pull_failedfehl.
Was ist der Unterschied zwischen einer Domain und einem URL-Präfix?
Entscheidend ist, was Sie nachweisen, und damit, welche URLs als verifiziert gelten. Eine Domain eignet sich für Medien auf einem Host, den Sie besitzen oder kontrollieren; ein Präfix eignet sich für einen Ordner auf einem Host, auf den Sie nur Dateien hochladen können. Die Regeln von TikTok für jeden Property-Typ:
| 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 |
Wie verifizieren Sie eine Property?
In zwei Aufrufen, die sich mit app_id und Secret der Entwickler-App statt mit einem Konto-Token authentifizieren. Dazwischen wird der Nachweis hinterlegt:
- Hinzufügen: POST /business/property/add/ mit
url_property_meta, dasproperty_typeund url enthält. Die Antwort liefert signature, bei einem Präfix zusätzlichfile_name, mitproperty_status0. - Nachweis erbringen: Legen Sie die Signatur bei einer Domain in einen DNS-TXT-Eintrag ab oder bei einem Präfix in eine öffentliche Datei namens
file_namemit einzelner .txt-Endung unter dem Präfix. - Prüfen: POST /business/property/verify/ mit demselben
url_property_meta;property_status1 bedeutet verifiziert, 2 bedeutet, dass der Versuch fehlgeschlagen ist.
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_nameWie lassen sich Properties auflisten oder entfernen?
GET /business/property/list/ mit app_id und Secret liefert url_property_info_list; jeder Eintrag enthält property_type, url, property_status, signature und file_name. Subdomains einer verifizierten Domain gelten ohne eigenen Aufruf als verifiziert, erscheinen aber nur dann in der Liste, wenn sie hinzugefügt wurden. POST /business/property/delete/ mit app_id, Secret und url_property_meta entfernt eine Property, die die App nicht mehr besitzt oder kontrolliert.
Können Sie statt einer URL eine Datei hochladen?
Nicht für Posts. Die Accounts API veröffentlicht ausschließlich aus URLs, auch Entwürfe, und ihr einziger Upload-Endpoint, /business/comment/image/upload/, nimmt ein Kommentarbild als Multipart-Formulardaten entgegen: JPG, JPEG, WebP oder PNG bis 5 MB. Er gibt eine image_uri für einen Kommentar oder eine Antwort zurück. Der Chunked-Upload gehört zur Content Posting API auf developers.tiktok.com, einer eigenen API mit eigenen Apps, deren Übertragungsmethode FILE_UPLOAD heißt.
Was passiert mit einer nicht verifizierten URL?
TikTok verweigert die Veröffentlichung daraus. Die Referenz der API for Business nennt die Regel für Videos und Fotos, aber keinen eigenen Rückgabecode dafür. Lesen Sie daher Code und Meldung in der Antwort. Die Content Posting API auf developers.tiktok.com nennt denselben Fall url_ownership_unverified mit HTTP 403. Um den Video-Endpoint zu testen, bevor eine Property verifiziert ist, stellt TikTok eine Test-Video-URL bereit, die ohne Verifizierung auskommt:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Wie bringt easyCoexistence Ihre Medien zu TikTok?
Über ein eigenes verifiziertes URL-Präfix, https://easycoexistence.com/api/social/media/. publish_tiktok_post nimmt Ihren HTTPS-Link entgegen, lehnt http:// ab, bevor etwas gesendet wird, und gibt TikTok einen Link unter diesem Präfix. Dieser enthält ein signiertes Token, das Ihre Datei benennt, nach 6 Stunden abläuft und die Dateiendung Ihrer Datei beibehält. Wenn TikTok ihn abruft, prüft easyCoexistence das Token, bestätigt, dass Ihr Link HTTPS auf einer öffentlichen Adresse nutzt, und streamt die Datei direkt von Ihrem Link, einschließlich Range-Anfragen und Weiterleitungen, ohne sie zu speichern. Schlägt Ihr Link fehl, kann TikTok die Datei nicht herunterladen und der Post scheitert.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Häufige Fehler
- Eine Subdomain verifizieren, Dateien aber auf deren übergeordneter Domain hosten. Eine verifizierte video.example.com deckt ihre eigenen Subdomains ab, nicht example.com selbst.
- Die Signaturdatei des Präfixes über eine Weiterleitung ausliefern. TikTok folgt bei einem URL-Präfix keinen Weiterleitungen und wertet eine 3xx-Antwort als ungültig.
- Die Signaturdatei als name.txt.txt speichern. TikTok erwartet, dass der Dateiname mit file_name übereinstimmt, mit einer einzigen .txt-Endung.
- Die Datei direkt nach dem Veröffentlichungsaufruf löschen. TikTok lädt sie danach bis zu einer Stunde lang herunter und lässt den Post scheitern, wenn der Link nicht mehr funktioniert.
Ihre Domain braucht daher keine Verifizierung. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, inklusive einer kostenlosen Testphase von 3 Tagen.
Häufig gestellte Fragen
Warum verlangt TikTok verifizierte Medien-URLs?
TikTok erklärt, die Verifizierung der Inhaberschaft von Video-URLs unterstütze die Einhaltung seiner Richtlinien zu urheberrechtlich geschützten Inhalten und zur Sicherheit der Nutzer.
Deckt eine verifizierte TikTok-Domain ihre Subdomains ab?
Ja. Subdomains einer verifizierten Domain gelten als verifiziert, auch wenn /business/property/list/ sie nur zeigt, wenn sie hinzugefügt wurden.
Kann die API for Business von TikTok über einen S3- oder CDN-Link veröffentlichen?
Ja, wenn der Link unter einer Domain oder einem URL-Präfix liegt, die die App verifiziert hat, etwa einem Präfix auf einem Bucket oder CDN-Pfad, den Sie kontrollieren.
Brauchen auch Foto-Posts verifizierte URLs?
Ja. Der Foto-Endpoint von TikTok besagt, dass Foto-Posts nicht aus unverifizierten Foto-URLs veröffentlicht werden können.
Weiterlesen
Verbinden Sie Ihren ersten Kanal in zwei Minuten.
Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.
- 3 Tage kostenlos
- Jederzeit kündbar
- Nur offizielle APIs
- Überwacht rund um die Uhr (24/7)
Verifiziert am