URL-urile media TikTok: domenii și prefixe URL verificate
API-ul TikTok for Business descarcă media postărilor de la URL-urile video_url, custom_thumbnail_url și photo_images. Fiecare URL trebuie să se afle pe un domeniu sau pe un prefix de URL a cărui proprietate a fost verificată de aplicația dezvoltatorului. Un domeniu se verifică printr-o înregistrare DNS TXT, iar un prefix printr-un fișier de semnătură plasat sub acesta, prin /business/property/add/ și /business/property/verify/, cu app_id și secretul aplicației.
easyCoexistence livrează media către TikTok din propriul prefix de URL verificat: publish_tiktok_post primește un link HTTPS de la Claude, ChatGPT sau din propriul cod și transmite fișierul de la acel link atunci când TikTok îl descarcă, deci domeniul nu necesită verificare.
De atunci, TikTok refuză URL-urile video care nu se află pe un domeniu sau prefix de URL verificat.
De atunci, endpoint-urile pentru proprietățile URL necesită și secretul aplicației dezvoltatorului.
Valorile property_type: 1 pentru un domeniu, 2 pentru un prefix de URL.
Valorile property_status: pending, verified și not verified, adică încercarea a eșuat și trebuie repetată.
Dezvoltatorii care au publicat videoclipuri înainte de această dată au avut domeniile URL-urilor video setate automat ca verificate.
Cea mai mare imagine acceptată de /business/comment/image/upload/, trimisă ca date de formular multipart, pentru un comentariu sau un răspuns.
Ce URL-uri descarcă TikTok?
Fiecare câmp media din cele două endpoint-uri de publicare este un URL pe care TikTok îl preia singur, după ce acceptă apelul, deci fișierul trebuie să rămână accesibil până se termină descărcarea:
video_url: videoclipul, pentru care TikTok recomandă să rămână valid cel puțin 30 de minute.custom_thumbnail_url: o imagine folosită ca copertă a videoclipului.photo_images: până la 35 de imagini pentru o postare cu fotografii.- Timeout: TikTok acordă descărcării o oră, apoi eșuează postarea cu
video_pull_failedsauphoto_pull_failed.
Care este diferența dintre un domeniu și un prefix de URL?
Ce dovedești că deții și, prin urmare, ce URL-uri sunt considerate verificate. Un domeniu este potrivit pentru media de pe un host pe care îl deții sau îl controlezi; un prefix este potrivit pentru un folder de pe un host în care poți doar să încarci fișiere. Regulile TikTok pentru fiecare tip de proprietate:
| 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 |
Cum verificați o proprietate?
Prin două apeluri care se autentifică cu app_id și secretul aplicației dezvoltatorului, în loc de un token de cont, cu dovada plasată între ele:
- Adăugați-o: POST /business/property/add/ cu
url_property_meta, care conțineproperty_typeși url; răspunsul oferă signature, plusfile_namepentru un prefix, cuproperty_status0. - Dovediți-o: plasați semnătura într-o înregistrare DNS TXT pentru un domeniu sau într-un fișier public numit
file_name, cu o singură extensie .txt, sub un prefix. - Verificați-o: POST /business/property/verify/ cu același
url_property_meta;property_status1 înseamnă verificată, iar 2 înseamnă că încercarea a eșuat.
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_nameCum listați sau eliminați proprietăți?
GET /business/property/list/ cu app_id și secret returnează url_property_info_list, fiecare intrare cu property_type, url, property_status, signature și file_name. Subdomeniile unui domeniu verificat sunt considerate verificate fără un apel propriu, dar apar în listă doar dacă au fost adăugate. POST /business/property/delete/ cu app_id, secret și url_property_meta elimină o proprietate pe care aplicația nu o mai deține sau nu o mai controlează.
Puteți încărca un fișier în loc de un URL?
Nu pentru postări. API-ul Accounts publică doar din URL-uri, inclusiv ciornele, iar singurul său endpoint de încărcare, /business/comment/image/upload/, primește o imagine de comentariu ca date de formular multipart, în format JPG, JPEG, WebP sau PNG, de până la 5 MB, și returnează un image_uri pentru un comentariu sau un răspuns. Încărcarea fișierelor pe bucăți ține de Content Posting API de pe developers.tiktok.com, un API separat, cu propriile aplicații, unde metoda de transfer se numește FILE_UPLOAD.
Ce se întâmplă cu un URL neverificat?
TikTok refuză să publice din el. Referința API for Business menționează regula pentru videoclipuri și fotografii, dar nu indică pentru acest caz un cod de returnare propriu, deci citiți codul și mesajul din răspuns. Content Posting API de pe developers.tiktok.com numește același caz url_ownership_unverified, cu HTTP 403. Pentru a testa endpoint-ul pentru videoclipuri înainte de a verifica orice proprietate, TikTok publică un URL de videoclip de test care nu necesită verificare:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Cum ajunge media la TikTok prin easyCoexistence?
Printr-un prefix de URL verificat propriu, https://easycoexistence.com/api/social/media/. publish_tiktok_post primește un link HTTPS, refuză http:// înainte de a trimite ceva și oferă TikTok un link sub acel prefix, cu un token semnat care denumește fișierul, expiră după 6 ore și păstrează extensia fișierului. Când TikTok îl preia, easyCoexistence verifică token-ul, confirmă că linkul folosește HTTPS pe o adresă publică și transmite fișierul direct de la link, inclusiv cererile range și redirecționările, fără a-l stoca. Dacă linkul eșuează, TikTok nu poate descărca fișierul, iar postarea eșuează.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Greșeli frecvente
- Verificarea unui subdomeniu și găzduirea fișierelor pe domeniul părinte. Un video.example.com verificat acoperă propriile subdomenii, nu și example.com.
- Servirea fișierului de semnătură al prefixului printr-o redirecționare. TikTok nu urmează redirecționările pentru un prefix de URL și tratează un răspuns 3xx ca invalid.
- Salvarea fișierului de semnătură ca name.txt.txt. TikTok cere ca numele fișierului să corespundă cu file_name, cu o singură extensie .txt.
- Ștergerea fișierului imediat după apelul de publicare. TikTok îl descarcă ulterior, timp de până la o oră, și eșuează postarea dacă linkul încetează să funcționeze.
De la US$ 9 la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
De ce cere TikTok URL-uri media verificate?
TikTok spune că verificarea proprietății URL-urilor video îl ajută să respecte politicile sale privind conținutul protejat prin drepturi de autor și siguranța utilizatorilor.
Un domeniu TikTok verificat acoperă și subdomeniile sale?
Da. Subdomeniile unui domeniu verificat sunt considerate verificate, deși /business/property/list/ le arată doar dacă au fost adăugate.
Poate API-ul TikTok for Business să publice dintr-un link S3 sau CDN?
Da, atunci când linkul se află sub un domeniu sau prefix de URL pe care aplicația le-a verificat, de exemplu un prefix pe un bucket sau pe un traseu CDN pe care îl controlați.
Postările cu fotografii au nevoie și ele de URL-uri verificate?
Da. Endpoint-ul TikTok pentru fotografii precizează că postările cu fotografii nu pot fi publicate din URL-uri de fotografii neverificate.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la