URL media TikTok: domain dan awalan URL terverifikasi
API for Business TikTok mengunduh media postingan dari URL: video_url, custom_thumbnail_url, dan photo_images. Setiap URL harus berada di domain atau awalan URL yang kepemilikannya telah diverifikasi aplikasi developer. Domain diverifikasi dengan rekaman DNS TXT, awalan dengan file tanda tangan yang diletakkan di bawahnya, lewat /business/property/add/ dan /business/property/verify/ dengan ID dan secret aplikasi.
easyCoexistence menyajikan media Anda ke TikTok dari awalan URL terverifikasi miliknya sendiri: publish_tiktok_post menerima tautan HTTPS dari Claude, ChatGPT, atau kode Anda sendiri, lalu mengalirkan file dari tautan itu saat TikTok mengunduhnya, sehingga domain Anda tidak perlu verifikasi.
Sejak itu, TikTok menolak URL video yang tidak berada di domain atau awalan URL yang terverifikasi.
Sejak itu, endpoint properti URL juga memerlukan secret aplikasi developer.
Nilai property_type: 1 untuk domain, 2 untuk awalan URL.
Nilai property_status: pending, verified, dan not verified, yaitu saat percobaan gagal dan harus diulang.
Developer yang mempublikasikan video sebelum itu, domain URL video mereka otomatis diatur sebagai terverifikasi.
Ukuran maksimum gambar yang diterima /business/comment/image/upload/, sebagai data formulir multipart, untuk komentar atau balasan.
URL mana yang diunduh TikTok?
Setiap field media di dua endpoint publikasi adalah URL yang diambil sendiri oleh TikTok setelah menerima panggilan, jadi file harus tetap bisa diakses sampai pengunduhan selesai:
video_url: video, yang disarankan TikTok tetap valid minimal 30 menit.custom_thumbnail_url: gambar yang dipakai sebagai sampul video.photo_images: hingga 35 gambar untuk postingan foto.- Batas waktu: TikTok memberi waktu satu jam untuk pengunduhan, lalu menggagalkan postingan dengan
video_pull_failedatauphoto_pull_failed.
Apa perbedaan domain dan awalan URL?
Apa yang Anda buktikan sebagai milik Anda, dan karenanya URL mana yang dihitung terverifikasi. Domain cocok untuk media di host yang Anda miliki atau kendalikan; awalan cocok untuk folder di host yang hanya bisa Anda unggah file-nya. Aturan TikTok untuk tiap jenis properti:
| 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 |
Bagaimana cara memverifikasi properti?
Lewat dua panggilan yang mengautentikasi dengan app_id dan secret aplikasi developer, bukan token akun, dengan bukti yang diletakkan di antara keduanya:
- Tambahkan: POST /business/property/add/ dengan
url_property_meta, berisiproperty_typedan url; jawabannya memuat signature, ditambahfile_nameuntuk awalan, denganproperty_status0. - Buktikan: letakkan signature di rekaman DNS TXT untuk domain, atau di file publik bernama
file_name, dengan satu ekstensi .txt, di bawah awalan. - Periksa: POST /business/property/verify/ dengan
url_property_metayang sama;property_status1 berarti terverifikasi, dan 2 berarti percobaan gagal.
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_nameBagaimana cara melihat atau menghapus properti?
GET /business/property/list/ dengan app_id dan secret mengembalikan url_property_info_list, dengan tiap entri memuat property_type, url, property_status, signature, dan file_name. Subdomain dari domain terverifikasi dihitung terverifikasi tanpa panggilan sendiri, tetapi hanya muncul di daftar jika memang ditambahkan. POST /business/property/delete/ dengan app_id, secret, dan url_property_meta menghapus properti yang tidak lagi dimiliki atau dikendalikan aplikasi.
Bisakah mengunggah file alih-alih URL?
Tidak untuk postingan. Accounts API hanya mempublikasikan dari URL, termasuk draf, dan satu-satunya endpoint unggah, /business/comment/image/upload/, menerima gambar komentar sebagai data formulir multipart, berformat JPG, JPEG, WebP, atau PNG hingga 5 MB, lalu mengembalikan image_uri untuk komentar atau balasan. Unggah file per bagian (chunked) termasuk Content Posting API di developers.tiktok.com, API terpisah dengan aplikasinya sendiri, tempat metode transfer disebut FILE_UPLOAD.
Apa yang terjadi dengan URL yang tidak terverifikasi?
TikTok menolak mempublikasikan dari URL tersebut. Referensi API for Business menyebutkan aturannya untuk video dan foto, tetapi tidak menyebut kode respons tersendiri untuk kasus ini, jadi baca kode dan pesan dalam respons. Content Posting API di developers.tiktok.com menyebut kasus yang sama url_ownership_unverified, dengan HTTP 403. Untuk mencoba endpoint video sebelum properti mana pun terverifikasi, TikTok menyediakan URL video uji yang tidak memerlukan verifikasi:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4Bagaimana easyCoexistence mengantarkan media Anda ke TikTok?
Lewat satu awalan URL terverifikasi miliknya sendiri, https://easycoexistence.com/api/social/media/. publish_tiktok_post menerima tautan HTTPS Anda, menolak http:// sebelum apa pun dikirim, dan memberi TikTok tautan di bawah awalan itu yang memuat token bertanda tangan yang menamai file Anda, kedaluwarsa dalam 6 jam, dan mempertahankan ekstensi file Anda. Saat TikTok mengambilnya, easyCoexistence memeriksa token, memastikan tautan Anda memakai HTTPS di alamat publik, dan mengalirkan file langsung dari tautan Anda, termasuk permintaan rentang (range) dan pengalihan, tanpa menyimpannya. Jika tautan Anda gagal, TikTok tidak bisa mengunduh file dan postingan gagal.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Kesalahan umum
- Memverifikasi subdomain lalu menyimpan file di induknya. video.example.com yang terverifikasi hanya mencakup subdomainnya sendiri, bukan example.com.
- Menyajikan file tanda tangan awalan lewat pengalihan. TikTok tidak mengikuti pengalihan untuk awalan URL dan menganggap jawaban 3xx tidak valid.
- Menyimpan file tanda tangan sebagai name.txt.txt. TikTok mengharapkan nama file sama dengan file_name, dengan satu ekstensi .txt.
- Menghapus file tepat setelah panggilan publikasi. TikTok mengunduhnya setelahnya, hingga satu jam, dan menggagalkan postingan jika tautan berhenti berfungsi.
US$ 9 hingga US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Mengapa TikTok mewajibkan URL media terverifikasi?
TikTok menyatakan bahwa verifikasi kepemilikan URL video membantunya mematuhi kebijakannya tentang konten berhak cipta dan keselamatan pengguna.
Apakah domain TikTok yang terverifikasi mencakup subdomainnya?
Ya. Subdomain dari domain terverifikasi dihitung terverifikasi, tetapi /business/property/list/ hanya menampilkannya jika memang ditambahkan.
Bisakah API for Business TikTok mempublikasikan dari tautan S3 atau CDN?
Bisa, jika tautan berada di bawah domain atau awalan URL yang telah diverifikasi aplikasi, misalnya awalan pada bucket atau jalur CDN yang Anda kendalikan.
Apakah postingan foto juga memerlukan URL terverifikasi?
Ya. Endpoint foto TikTok menyatakan bahwa postingan foto tidak dapat dipublikasikan dari URL foto yang belum terverifikasi.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada