Log masukMulakan percubaan percuma
easyCoexistence API rasmi

URL media TikTok: domain dan awalan URL yang disahkan

API for Business TikTok memuat turun media siaran daripada URL: video_url, custom_thumbnail_url dan photo_images. Setiap URL mesti berada pada domain atau awalan URL yang pemilikannya telah disahkan oleh aplikasi pembangun. Domain disahkan dengan rekod DNS TXT, dan awalan dengan fail tandatangan yang diletakkan di bawahnya, melalui /business/property/add/ dan /business/property/verify/ dengan ID dan rahsia aplikasi.

easyCoexistence menghidangkan media anda kepada TikTok daripada awalan URL disahkan miliknya sendiri: publish_tiktok_post menerima pautan HTTPS daripada Claude, ChatGPT atau kod anda sendiri dan menstrim fail daripadanya apabila TikTok memuat turun, jadi domain anda tidak memerlukan pengesahan.

Nov 16, 2023

Sejak itu, TikTok menolak URL video yang tidak berada pada domain atau awalan URL yang disahkan.

Oct 15, 2025

Sejak itu, endpoint property URL juga memerlukan rahsia aplikasi pembangun.

1 / 2

Nilai property_type: 1 untuk domain, 2 untuk awalan URL.

0, 1, 2

Nilai property_status: pending, verified dan not verified, yang bermakna percubaan gagal dan mesti diulang.

Apr 7, 2023

Pembangun yang pernah menerbitkan video sebelum itu mendapati domain bagi URL video mereka ditetapkan kepada verified secara automatik.

5 MB

Imej terbesar yang diterima oleh /business/comment/image/upload/, sebagai multipart form data, untuk komen atau balasan.

URL yang mana dimuat turun oleh TikTok?

Setiap medan media dalam dua endpoint penerbitan ialah URL yang TikTok ambil sendiri selepas menerima panggilan, jadi fail mesti kekal boleh diakses sehingga muat turun tamat:

  • video_url: video, yang TikTok cadangkan supaya kekal sah sekurang-kurangnya 30 minit.
  • custom_thumbnail_url: imej untuk dijadikan imej muka depan video.
  • photo_images: sehingga 35 imej untuk siaran foto.
  • Tamat masa: TikTok memberi muat turun masa selama satu jam, kemudian gagalkan siaran dengan video_pull_failed atau photo_pull_failed.

Apakah perbezaan antara domain dan awalan URL?

Apa yang anda buktikan milik anda, dan oleh itu URL mana yang dikira sebagai disahkan. Domain sesuai untuk media pada hos yang anda miliki atau kawal; awalan sesuai untuk folder pada hos yang anda hanya boleh muat naik fail. Peraturan TikTok bagi setiap jenis property ialah:

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

Bagaimana anda mengesahkan property?

Melalui dua panggilan yang disahkan dengan app_id dan rahsia aplikasi pembangun dan bukannya token akaun, dengan bukti diletakkan di antara keduanya:

  • Tambah: POST /business/property/add/ dengan url_property_meta, yang memuatkan property_type dan url. Jawapan memberikan signature, serta file_name bagi awalan, dengan property_status 0.
  • Buktikan: letakkan signature dalam rekod DNS TXT bagi domain, atau dalam fail awam bernama file_name, dengan satu sambungan .txt, di bawah awalan.
  • Semak: POST /business/property/verify/ dengan url_property_meta yang sama. property_status 1 bermakna disahkan, dan 2 bermakna percubaan gagal.
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

Bagaimana anda menyenaraikan atau memadam property?

GET /business/property/list/ dengan app_id dan rahsia memulangkan url_property_info_list, dengan setiap entri mengandungi property_type, url, property_status, signature dan file_name. Subdomain bagi domain yang disahkan dikira sebagai disahkan tanpa panggilan sendiri, tetapi hanya muncul dalam senarai jika ia telah ditambah. POST /business/property/delete/ dengan app_id, rahsia dan url_property_meta menggugurkan property yang tidak lagi dimiliki atau dikawal oleh aplikasi.

Bolehkah anda memuat naik fail dan bukannya URL?

Tidak untuk siaran. API Accounts hanya menerbitkan daripada URL, termasuk draf, dan satu-satunya endpoint muat naik, /business/comment/image/upload/, menerima imej komen sebagai multipart form data, JPG, JPEG, WebP atau PNG sehingga 5 MB, dan memulangkan image_uri untuk komen atau balasan. Muat naik berketul tergolong dalam Content Posting API di developers.tiktok.com, sebuah API berasingan dengan aplikasinya sendiri, di mana kaedah pemindahan dipanggil FILE_UPLOAD.

Apakah yang berlaku dengan URL yang tidak disahkan?

TikTok enggan menerbitkan daripadanya. Rujukan API for Business menyatakan peraturan untuk video dan foto tetapi tidak menamakan kod pulangan tersendiri untuknya, jadi baca kod dan mesej dalam respons. Content Posting API di developers.tiktok.com memanggil kes yang sama url_ownership_unverified, dengan HTTP 403. Untuk mencuba endpoint video sebelum mana-mana property disahkan, TikTok menyediakan URL video ujian yang tidak memerlukan pengesahan:

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

Bagaimana easyCoexistence menghantar media anda ke TikTok?

Melalui satu awalan URL disahkan miliknya sendiri, https://easycoexistence.com/api/social/media/. publish_tiktok_post menerima pautan HTTPS anda, menolak http:// sebelum apa-apa dihantar, dan memberikan TikTok pautan di bawah awalan itu yang memuatkan token bertandatangan yang menamakan fail anda, tamat tempoh selepas 6 jam dan mengekalkan sambungan fail anda. Apabila TikTok mengambilnya, easyCoexistence menyemak token, mengesahkan pautan anda menggunakan HTTPS pada alamat awam, dan menstrim fail terus dari pautan anda, termasuk permintaan julat dan ubah hala, tanpa menyimpannya. Jika pautan anda gagal, TikTok tidak dapat memuat turun fail dan siaran gagal.

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

Kesilapan biasa

  • Mengesahkan subdomain dan menghoskan fail pada induknya. video.example.com yang disahkan meliputi subdomainnya sendiri, bukan example.com itu sendiri.
  • Menghantar fail tandatangan awalan melalui ubah hala. TikTok tidak mengikut ubah hala bagi awalan URL dan menganggap jawapan 3xx sebagai tidak sah.
  • Menyimpan fail tandatangan sebagai name.txt.txt. TikTok mahu nama fail sepadan dengan file_name, dengan satu sambungan .txt.
  • Memadam fail sejurus selepas panggilan penerbitan. TikTok memuat turunnya selepas itu, sehingga satu jam, dan siaran gagal jika pautan tidak lagi berfungsi.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Mengapa TikTok memerlukan URL media yang disahkan?

TikTok berkata mengesahkan pemilikan URL video membantunya mematuhi dasarnya mengenai kandungan berhak cipta dan keselamatan pengguna.

Adakah domain TikTok yang disahkan meliputi subdomainnya?

Ya. Subdomain bagi domain yang disahkan dikira sebagai disahkan, walaupun /business/property/list/ hanya menunjukkannya jika ia telah ditambah.

Bolehkah API for Business TikTok menerbitkan daripada pautan S3 atau CDN?

Boleh, apabila pautan berada di bawah domain atau awalan URL yang disahkan oleh aplikasi, seperti awalan pada bucket atau laluan CDN yang anda kawal.

Adakah siaran foto juga memerlukan URL yang disahkan?

Ya. Endpoint foto TikTok menyatakan bahawa siaran foto tidak boleh diterbitkan daripada URL foto yang tidak disahkan.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada