TikTok media URL-ovi: verifikovani domeni i URL prefiksi
TikTok API for Business preuzima medije objava sa URL-ova: video_url, custom_thumbnail_url i photo_images. Svaki URL mora da se nalazi na domenu ili URL prefiksu koje developer aplikacija verifikuje. Domen se verifikuje DNS TXT zapisom, a prefiks potpisnim fajlom postavljenim ispod njega, preko /business/property/add/ i /business/property/verify/ uz ID aplikacije i secret.
easyCoexistence poslužuje vaše medije TikToku sa sopstvenog verifikovanog URL prefiksa: publish_tiktok_post prihvata HTTPS link iz Claude-a, ChatGPT-ja ili vašeg koda i prosleđuje fajl sa njega kada TikTok preuzima, pa vaš domen ne zahteva verifikaciju.
Od tada TikTok odbija video URL-ove koji nisu na verifikovanom domenu ili URL prefiksu.
Od tada property endpointi za URL-ove takođe zahtevaju secret developer aplikacije.
Vrednosti property_type: 1 za domen, 2 za URL prefiks.
Vrednosti property_status: pending, verified i not verified, što znači da pokušaj nije uspeo i mora da se ponovi.
Developeri koji su objavljivali video pre tada imali su domene tih URL-ova automatski označene kao verifikovane.
Najveća veličina slike koju /business/comment/image/upload/ prihvata kao multipart form data, za komentar ili odgovor.
Koje URL-ove TikTok preuzima?
Svako medijsko polje u dva endpointa za objavljivanje je URL koji TikTok sam preuzima nakon što prihvati poziv, zato fajl mora ostati dostupan dok preuzimanje ne završi:
video_url: video, za koji TikTok preporučuje da ostane važeći najmanje 30 minuta.custom_thumbnail_url: slika koja se koristi kao naslovna slika videa.photo_images: do 35 slika za foto objavu.- Tajm-aut: TikTok daje preuzimanju jedan sat, a zatim objavu označava kao neuspelu sa
video_pull_failediliphoto_pull_failed.
Po čemu se domen razlikuje od URL prefiksa?
Po tome šta dokazujete da posedujete, a time i koji URL-ovi se računaju kao verifikovani. Domen je pogodan za medije na hostu koji posedujete ili kontrolišete, a prefiks za fasciklu na hostu na koji možete samo da otpremate fajlove. TikTokova pravila za svaki tip property-ja:
| 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 |
Kako se property verifikuje?
Preko dva poziva koja se autentifikuju preko app_id i secret developer aplikacije, a dokaz se postavlja između njih:
- Dodajte ga: POST /business/property/add/ sa
url_property_meta, koji sadržiproperty_typei url; odgovor daje signature, uzfile_nameza prefiks, saproperty_status0. - Dokažite: postavite potpis u DNS TXT zapis za domen, ili u javno dostupan fajl pod nazivom
file_name, sa jednom ekstenzijom .txt, ispod prefiksa. - Proverite: POST /business/property/verify/ sa istim
url_property_meta;property_status1 znači verifikovano, a 2 znači da pokušaj nije uspeo.
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_nameKako se property-ji prikazuju ili uklanjaju?
GET /business/property/list/ sa app_id i secret vraća url_property_info_list, a svaki unos ima property_type, url, property_status, signature i file_name. Poddomeni verifikovanog domena važe kao verifikovani bez sopstvenog poziva, ali se u listi pojavljuju samo ako su dodati. POST /business/property/delete/ sa app_id, secret i url_property_meta uklanja property koji aplikacija više ne poseduje ili ne kontroliše.
Možete li da otpremite fajl umesto URL-a?
Ne za objave. Accounts API objavljuje samo iz URL-ova, uključujući nacrte, a njegov jedini endpoint za otpremanje, /business/comment/image/upload/, prima sliku komentara kao multipart form data, JPG, JPEG, WebP ili PNG do 5 MB, i vraća image_uri za komentar ili odgovor. Otpremanje u delovima (chunked) pripada Content Posting API-ju na developers.tiktok.com, zasebnom API-ju sa sopstvenim aplikacijama, gde se metod prenosa zove FILE_UPLOAD.
Šta se dešava sa URL-om koji nije verifikovan?
TikTok odbija da objavi iz njega. Referenca API for Business navodi pravilo za videe i fotografije, ali za njega ne navodi sopstveni kod odgovora, zato pročitajte kod i poruku u odgovoru. Content Posting API na developers.tiktok.com za isti slučaj koristi url_ownership_unverified, uz HTTP 403. Da biste isprobali video endpoint pre nego što se verifikuje bilo koji property, TikTok objavljuje testni URL videa koji ne zahteva verifikaciju:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Kako easyCoexistence dostavlja vaše medije TikToku?
Preko sopstvenog verifikovanog URL prefiksa, https://easycoexistence.com/api/social/media/. publish_tiktok_post prihvata vaš HTTPS link, odbija http:// pre nego što išta pošalje i TikToku daje link pod tim prefiksom, sa potpisanim tokenom koji sadrži naziv vašeg fajla, ističe posle 6 sati i čuva ekstenziju vašeg fajla. Kada TikTok to preuzme, easyCoexistence proverava token, potvrđuje da vaš link koristi HTTPS na javnoj adresi i prosleđuje fajl direktno sa vašeg linka, uključujući range zahteve i preusmeravanja, bez skladištenja. Ako vaš link ne uspe, TikTok ne može da preuzme fajl i objava ne uspeva.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Česte greške
- Verifikovanje poddomena, a hostovanje fajlova na roditeljskom domenu. Verifikovani video.example.com pokriva sopstvene poddomene, a ne samog example.com.
- Posluživanje potpisnog fajla prefiksa preko preusmeravanja. TikTok ne prati preusmeravanja za URL prefiks i odgovor 3xx tretira kao nevažeći.
- Čuvanje potpisnog fajla kao name.txt.txt. TikTok želi da se naziv fajla poklapa sa file_name, sa jednom ekstenzijom .txt.
- Brisanje fajla odmah posle poziva za objavu. TikTok ga preuzima naknadno, do jedan sat, i objavu označava kao neuspelu ako link prestane da radi.
US$ 9 do US$ 0.75 po vezi mesečno, a pada kako dodajete veze, uz besplatni probni period od 3 dana.
Često postavljana pitanja
Zašto TikTok zahteva verifikovane URL-ove medija?
TikTok kaže da verifikacija vlasništva video URL-ova pomaže da se ispune njegove politike o sadržaju zaštićenom autorskim pravima i bezbednosti korisnika.
Da li verifikovani TikTok domen pokriva i njegove poddomene?
Da. Poddomeni verifikovanog domena važe kao verifikovani, ali ih /business/property/list/ prikazuje samo ako su dodati.
Može li TikTok API for Business da objavljuje sa S3 ili CDN linka?
Može, kada se link nalazi ispod domena ili URL prefiksa koje aplikacija verifikovala, na primer prefiksa na bucketu ili CDN putanji koju kontrolišete.
Da li i fotografije moraju imati verifikovane URL-ove?
Da. TikTokov endpoint za fotografije navodi da se foto objave ne mogu objaviti sa neverifikovanih URL-ova fotografija.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na