TikTok-median URL-osoitteet: vahvistetut verkkotunnukset ja URL-etuliitteet
TikTokin API for Business lataa julkaisun median URL-osoitteista: video_url, custom_thumbnail_url ja photo_images. Jokaisen URL-osoitteen on oltava verkkotunnuksella tai URL-etuliitteellä, jonka omistajuuden kehittäjäsovellus on vahvistanut. Verkkotunnus vahvistetaan DNS TXT -tietueella ja etuliite sen alle sijoitettavalla allekirjoitustiedostolla kutsuilla /business/property/add/ ja /business/property/verify/ sovelluksen ID:n ja salaisuuden avulla.
easyCoexistence toimittaa mediasi TikTokiin omasta vahvistetusta URL-etuliitteestään: publish_tiktok_post ottaa HTTPS-linkin Claudelta, ChatGPT:ltä tai omasta koodistasi ja striimaa tiedoston siitä, kun TikTok lataa sen, joten verkkotunnuksesi ei tarvitse vahvistusta.
Tästä lähtien TikTok hylkää videoiden URL-osoitteet, jotka eivät sijaitse vahvistetulla verkkotunnuksella tai URL-etuliitteellä.
Tästä lähtien myös URL-kohteiden päätepisteet vaativat kehittäjäsovelluksen salaisuuden.
property_type-arvot: 1 verkkotunnukselle, 2 URL-etuliitteelle.
property_status-arvot: pending, verified ja not verified, jolloin yritys epäonnistui ja se on toistettava.
Ennen sitä julkaisseiden kehittäjien videoiden URL-osoitteiden verkkotunnukset merkittiin automaattisesti vahvistetuiksi.
Suurin kuvakoko, jonka /business/comment/image/upload/ hyväksyy monimuotoisena lomakedatana kommenttiin tai vastaukseen.
Mitä URL-osoitteita TikTok lataa?
Jokainen mediakenttä kahdessa julkaisupäätepisteessä on URL, jonka TikTok hakee itse kutsun hyväksyttyään. Tiedoston on siksi pysyttävä saavutettavana, kunnes lataus päättyy:
video_url: video, jonka TikTok suosittelee pidettävän voimassa vähintään 30 minuuttia.custom_thumbnail_url: kuva, jota käytetään videon kansikuvana.photo_images: enintään 35 kuvaa kuvajulkaisua varten.- Aikaraja: TikTok antaa lataukselle tunnin, minkä jälkeen julkaisu epäonnistuu virheellä
video_pull_failedtaiphoto_pull_failed.
Mitä eroa on verkkotunnuksella ja URL-etuliitteellä?
Mitä todistat omistavasi ja siten, mitkä URL-osoitteet lasketaan vahvistetuiksi. Verkkotunnus sopii palvelimella, jonka omistat tai hallitset, olevalle medialle. Etuliite sopii kansioon isännällä, jolle voit vain ladata tiedostoja. TikTokin säännöt kullekin kohdetyypille:
| 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 |
Miten kohde vahvistetaan?
Kahdella kutsulla, jotka todennetaan kehittäjäsovelluksen app_id:llä ja salaisuudella tilin tokenin sijaan. Todiste asetetaan niiden väliin:
- Lisää se: POST /business/property/add/ kentällä
url_property_meta, joka sisältääproperty_type- ja url-arvot. Vastaus antaa signature-arvon sekä etuliitteelle tiedostonimenfile_name,property_status-arvolla 0. - Todista se: aseta allekirjoitus verkkotunnuksen DNS TXT -tietueeseen tai etuliitteen alla olevaan julkiseen tiedostoon nimeltä
file_name, jonka pääte on yksi .txt. - Tarkista se: POST /business/property/verify/ samalla
url_property_meta-kentällä.property_status1 tarkoittaa vahvistettu, 2 tarkoittaa yritys epäonnistui.
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_nameMiten kohteita listataan tai poistetaan?
GET /business/property/list/ palauttaa parametreina app_id ja secret kentän url_property_info_list, jonka jokainen kohde sisältää kentät property_type, url, property_status, signature ja file_name. Vahvistetun verkkotunnuksen alidomainit lasketaan vahvistetuiksi ilman omaa kutsuaan, mutta ne näkyvät listassa vain, jos ne on lisätty. POST /business/property/delete/ poistaa parametreilla app_id, secret ja url_property_meta kohteen, jota sovellus ei enää omista tai hallitse.
Voiko tiedoston ladata URL-osoitteen sijaan?
Ei julkaisuissa. Accounts API julkaisee vain URL-osoitteista, myös luonnoksina, ja sen ainoa latauspäätepiste, /business/comment/image/upload/, ottaa kommentin kuvan monimuotoisena lomakedatana: JPG, JPEG, WebP tai PNG enintään 5 MB, ja palauttaa image_uri-arvon kommenttiin tai vastaukseen. Paloittainen tiedostolataus kuuluu Content Posting API:n developers.tiktok.com-sivustolla olevaan, erilliseen rajapintaan omine sovelluksineen, jossa siirtotapaa kutsutaan nimellä FILE_UPLOAD.
Mitä tapahtuu vahvistamattomalle URL-osoitteelle?
TikTok kieltäytyy julkaisemasta siitä. API for Business -viitteessä sääntö on kuvattu videoille ja kuville, mutta sille ei ole omaa vastauskoodia, joten lue vastauksen koodi ja viesti. Content Posting API:n developers.tiktok.com-sivustolla kutsuu saman tapauksen nimellä url_ownership_unverified, HTTP 403. Jotta videopäätepisteen voi kokeilla ennen kuin mitään kohdetta on vahvistettu, TikTok julkaisee testivideon URL-osoitteen, joka ei vaadi vahvistusta:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Miten easyCoexistence toimittaa mediasi TikTokiin?
Yhden oman vahvistetun URL-etuliitteen kautta: https://easycoexistence.com/api/social/media/. publish_tiktok_post ottaa HTTPS-linkkisi, hylkää http:// ennen kuin mitään lähetetään, ja antaa TikTokille linkin tämän etuliitteen alla. Linkissä on allekirjoitettu token, joka nimeää tiedostosi, vanhenee 6 tunnissa ja säilyttää tiedostosi päätteen. Kun TikTok hakee linkin, easyCoexistence tarkistaa tokenin, varmistaa, että linkkisi käyttää HTTPS:ää julkisessa osoitteessa, ja striimaa tiedoston suoraan linkistäsi tallentamatta sitä, mukaan lukien range-pyynnöt ja uudelleenohjaukset. Jos linkkisi epäonnistuu, TikTok ei voi ladata tiedostoa ja julkaisu epäonnistuu.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Yleiset virheet
- Subdomainin vahvistaminen ja tiedostojen isännöinti sen ylädomainilla. Vahvistettu video.example.com kattaa omat alidomainsa, ei example.comia itseään.
- Etuliitteen allekirjoitustiedoston palveleminen uudelleenohjauksen kautta. TikTok ei seuraa uudelleenohjauksia URL-etuliitteelle ja käsittelee 3xx-vastauksen virheellisenä.
- Allekirjoitustiedoston tallentaminen nimellä name.txt.txt. TikTok vaatii, että tiedoston nimi vastaa file_name-arvoa ja pääte on yksi .txt.
- Tiedoston poistaminen heti julkaisukutsun jälkeen. TikTok lataa tiedoston myöhemmin, enintään tunnin ajan, ja julkaisu epäonnistuu, jos linkki lakkaa toimimasta.
US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksien määrän kasvaessa, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Miksi TikTok vaatii vahvistetut median URL-osoitteet?
TikTok sanoo, että videoiden URL-osoitteiden omistajuuden vahvistaminen auttaa sitä noudattamaan tekijänoikeudella suojattua sisältöä ja käyttäjien turvallisuutta koskevia käytäntöjään.
Kattaako vahvistettu TikTok-verkkotunnus sen alidomainit?
Kyllä. Vahvistetun verkkotunnuksen alidomainit lasketaan vahvistetuiksi, mutta /business/property/list/ näyttää ne vain, jos ne on lisätty.
Voiko TikTokin API for Business julkaista S3- tai CDN-linkistä?
Kyllä, kun linkki sijaitsee verkkotunnuksen tai URL-etuliitteen alla, jonka sovellus on vahvistanut, esimerkiksi sinun hallitsemasi bucketin tai CDN-polun etuliitteen alla.
Tarvitsevatko kuvajulkaisut myös vahvistetut URL-osoitteet?
Kyllä. TikTokin kuvapäätepiste ilmoittaa, että kuvajulkaisuja ei voi julkaista vahvistamattomista kuva-URL-osoitteista.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu