Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

URL-ovi medija za TikTok: provjerene domene i URL prefiksi

TikTokov API for Business preuzima medijske datoteke s URL-ova: video_url, custom_thumbnail_url i photo_images. Svaki URL mora biti na domeni ili URL prefiksu čije je vlasništvo aplikacija za razvojne programere provjerila. Domena se provjerava DNS TXT zapisom, a prefiks datotekom potpisa postavljenom pod njim, putem /business/property/add/ i /business/property/verify/ uz ID i tajnu aplikacije.

easyCoexistence služi vaše medije TikToku s vlastitog provjerenog URL prefiksa: publish_tiktok_post prihvaća HTTPS poveznicu iz Claudea, ChatGPT-a ili vašeg koda i prenosi datoteku s nje kad TikTok preuzima, pa vaša domena ne treba provjeru.

Nov 16, 2023

Otada TikTok odbija URL-ove videa koji nisu na provjerenoj domeni ili URL prefiksu.

Oct 15, 2025

Otada krajnje točke URL svojstava također zahtijevaju tajnu razvojne aplikacije.

1 / 2

Vrijednosti property_type: 1 za domenu, 2 za URL prefiks.

0, 1, 2

Vrijednosti property_status: pending (na čekanju), verified (provjereno) i not verified (neprovjereno, jer pokušaj nije uspio i treba ga ponoviti).

Apr 7, 2023

Razvojni programeri koji su prije toga objavljivali videe imali su domene njihovih URL-ova videa automatski označene kao provjerene.

5 MB

Najveća veličina slike koju /business/comment/image/upload/ prihvaća, kao multipart podaci obrasca, za komentar ili odgovor.

Koje URL-ove TikTok preuzima?

Svako polje medija u dvjema objavnim krajnjim točkama je URL koji TikTok sam dohvaća nakon što prihvati poziv, pa datoteka mora ostati dostupna dok preuzimanje ne završi:

  • video_url: video, za koji TikTok preporučuje da ostane valjan najmanje 30 minuta.
  • custom_thumbnail_url: slika koja se koristi kao naslovna slika videa.
  • photo_images: do 35 slika za objavu fotografija.
  • Istek vremena: TikTok preuzimanju daje sat vremena, zatim objavu označava kao neuspjelu s video_pull_failed ili photo_pull_failed.

Koja je razlika između domene i URL prefiksa?

Ono što dokazujete da posjedujete, a time i koji se URL-ovi smatraju provjerenima. Domena odgovara medijima na hostu koji posjedujete ili kojim upravljate; prefiks odgovara mapi na hostu na koji možete samo učitavati datoteke. Pravila TikToka za svaku vrstu svojstva:

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

Kako provjeriti svojstvo?

Dvama pozivima koji se ovjeravaju pomoću app_id i tajne razvojne aplikacije, a ne tokena računa, uz dokaz postavljen između njih:

  • Dodavanje: POST /business/property/add/ s url_property_meta, koji sadrži property_type i url; odgovor vraća signature, uz file_name za prefiks, s property_status 0.
  • Dokaz: stavite signature u DNS TXT zapis za domenu ili u javnu datoteku naziva file_name, s jednom ekstenzijom .txt, pod prefiksom.
  • Provjera: POST /business/property/verify/ s istim url_property_meta; property_status 1 znači provjereno, a 2 znači da je pokušaj propao.
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

Kako popisati ili ukloniti svojstva?

GET /business/property/list/ s app_id i secret vraća url_property_info_list, a svaki unos sadrži property_type, url, property_status, signature i file_name. Poddomene provjerene domene smatraju se provjerenima bez vlastitog poziva, ali se na popisu pojavljuju samo ako su dodane. POST /business/property/delete/ s app_id, secret i url_property_meta uklanja svojstvo kojim aplikacija više ne upravlja ili ga ne kontrolira.

Možete li umjesto URL-a učitati datoteku?

Ne za objave. Accounts API objavljuje samo iz URL-ova, uključujući nacrte, a njegova jedina krajnja točka za učitavanje, /business/comment/image/upload/, prihvaća sliku komentara kao multipart podatke obrasca, u JPG, JPEG, WebP ili PNG formatu do 5 MB, te vraća image_uri za komentar ili odgovor. Učitavanje u dijelovima pripada Content Posting API-ju na developers.tiktok.com, zasebnom API-ju s vlastitim aplikacijama, gdje se način prijenosa zove FILE_UPLOAD.

Što se događa s URL-om koji nije provjeren?

TikTok odbija objavu s njega. Referenca API for Business navodi pravilo za videe i fotografije, ali za to nema vlastiti povratni kôd, pa pročitajte kôd i poruku u odgovoru. Content Posting API na developers.tiktok.com za isti slučaj koristi naziv url_ownership_unverified, uz HTTP 403. Za isprobavanje krajnje točke za videe prije provjere bilo kojeg svojstva, TikTok objavljuje testni URL videa koji ne zahtijeva provjeru:

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

Kako easyCoexistence šalje vaše medije TikToku?

Preko jednog vlastitog provjerenog URL prefiksa, https://easycoexistence.com/api/social/media/. publish_tiktok_post prihvaća vašu HTTPS poveznicu, odbija http:// prije slanja bilo čega i TikToku daje poveznicu pod tim prefiksom koja sadrži potpisani token koji imenuje vašu datoteku, istječe za 6 sati i zadržava ekstenziju vaše datoteke. Kad TikTok to dohvati, easyCoexistence provjerava token, potvrđuje da vaša poveznica koristi HTTPS na javnoj adresi i izravno prenosi datoteku s vaše poveznice, uključujući range zahtjeve i preusmjeravanja, bez pohranjivanja. Ako vaša poveznica ne uspije, TikTok ne može preuzeti datoteku i objava ne uspijeva.

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

Uobičajene pogreške

  • Provjera poddomene i smještaj datoteka na njezinoj nadređenoj domeni. Provjerena video.example.com pokriva vlastite poddomene, a ne samu example.com.
  • Posluživanje datoteke potpisa URL prefiksa kroz preusmjeravanje. TikTok ne prati preusmjeravanja za URL prefiks i odgovor 3xx smatra neispravnim.
  • Spremanje datoteke potpisa kao name.txt.txt. TikTok želi da naziv datoteke odgovara file_name, s jednom ekstenzijom .txt.
  • Brisanje datoteke odmah nakon poziva za objavu. TikTok je preuzima naknadno, do sat vremena, i objava ne uspijeva ako poveznica prestane raditi.
Radite ovo uz EasyCoexistence

Od US$ 9 do US$ 0,75 po vezi mjesečno, cijena pada kako dodajete veze, a prva 3 dana su besplatna.

Često postavljana pitanja

Zašto TikTok traži provjerene URL-ove medija?

TikTok kaže da provjera vlasništva URL-ova videa pomaže u usklađivanju s njegovim pravilima o zaštićenom sadržaju i sigurnosti korisnika.

Pokriva li provjerena TikTok domena i njezine poddomene?

Da. Poddomene provjerene domene smatraju se provjerenima, ali ih /business/property/list/ prikazuje samo ako su dodane.

Može li TikTokov API for Business objavljivati s S3 ili CDN poveznice?

Da, kada se poveznica nalazi pod domenom ili URL prefiksom koji je aplikacija provjerila, primjerice prefiksom na spremniku ili CDN putanji koju kontrolirate.

Trebaju li i objave fotografija provjerene URL-ove?

Da. TikTokova krajnja točka za fotografije navodi da se objave fotografija ne mogu objaviti s neprovjerenih URL-ova fotografija.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na