Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

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.

Nov 16, 2023

De atunci, TikTok refuză URL-urile video care nu se află pe un domeniu sau prefix de URL verificat.

Oct 15, 2025

De atunci, endpoint-urile pentru proprietățile URL necesită și secretul aplicației dezvoltatorului.

1 / 2

Valorile property_type: 1 pentru un domeniu, 2 pentru un prefix de URL.

0, 1, 2

Valorile property_status: pending, verified și not verified, adică încercarea a eșuat și trebuie repetată.

Apr 7, 2023

Dezvoltatorii care au publicat videoclipuri înainte de această dată au avut domeniile URL-urilor video setate automat ca verificate.

5 MB

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_failed sau photo_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:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot 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ține property_type și url; răspunsul oferă signature, plus file_name pentru un prefix, cu property_status 0.
  • 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_status 1 înseamnă verificată, iar 2 înseamnă că încercarea a eșuat.
Add a URL prefix
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

Cum 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:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Cum 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ă.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Greș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.
Faceți acest lucru cu EasyCoexistence

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