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.
Otada TikTok odbija URL-ove videa koji nisu na provjerenoj domeni ili URL prefiksu.
Otada krajnje točke URL svojstava također zahtijevaju tajnu razvojne aplikacije.
Vrijednosti property_type: 1 za domenu, 2 za URL prefiks.
Vrijednosti property_status: pending (na čekanju), verified (provjereno) i not verified (neprovjereno, jer pokušaj nije uspio i treba ga ponoviti).
Razvojni programeri koji su prije toga objavljivali videe imali su domene njihovih URL-ova videa automatski označene kao provjerene.
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_failediliphoto_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:
| 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 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žiproperty_typei url; odgovor vraća signature, uzfile_nameza prefiks, sproperty_status0. - 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_status1 znači provjereno, a 2 znači da je pokušaj propao.
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 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:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Kako 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.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Uobič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.
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