TikTok medya URL'leri: doğrulanmış domain'ler ve URL önekleri
TikTok'un İşletme API'si medya dosyalarını URL'lerden indirir: video_url, custom_thumbnail_url ve photo_images. Her URL, geliştirici uygulamasının sahipliğini doğruladığı bir domain'de veya URL önekinde bulunmalıdır. Domain bir DNS TXT kaydıyla, önek ise altına yerleştirilen bir imza dosyasıyla doğrulanır; bu işlem uygulamanın ID'si ve secret'ı ile /business/property/add/ ve /business/property/verify/ uç noktaları üzerinden yapılır.
easyCoexistence, medyanızı TikTok'a kendi doğrulanmış URL önekinden sunar: publish_tiktok_post, Claude, ChatGPT ya da kendi kodunuzdan bir HTTPS bağlantısı alır ve TikTok indirirken dosyayı o bağlantıdan aktarır; bu nedenle domain'inizin doğrulanmasına gerek yoktur.
Bu tarihten itibaren TikTok, doğrulanmış bir domain'de veya URL önekinde olmayan video URL'lerini kabul etmez.
Bu tarihten itibaren URL mülk uç noktaları da geliştirici uygulamasının secret'ını gerektirir.
property_type değerleri: domain için 1, URL öneki için 2.
property_status değerleri: pending, verified ve not verified; not verified, denemenin başarısız olduğu ve yeniden yapılması gerektiği anlamına gelir.
Bu tarihten önce video yayınlayan geliştiricilerin video URL'lerinin domain'leri otomatik olarak doğrulanmış olarak ayarlandı.
/business/comment/image/upload/ uç noktasının, yorum veya yanıt için multipart form verisi olarak kabul ettiği en büyük görsel boyutu.
TikTok hangi URL'leri indirir?
İki yayınlama uç noktasındaki her medya alanı, TikTok'un çağrıyı kabul ettikten sonra kendisinin getirdiği bir URL'dir; bu nedenle indirme bitene kadar dosyaya ulaşılabilir kalmalıdır:
video_url: video. TikTok, bu bağlantının en az 30 dakika geçerli kalmasını önerir.custom_thumbnail_url: videonun kapak görseli olarak kullanılacak bir görsel.photo_images: bir fotoğraf gönderisi için en fazla 35 görsel.- Zaman aşımı: TikTok indirme için bir saat tanır; sonra gönderiyi
video_pull_failedveyaphoto_pull_failedhatasıyla başarısız sayar.
Domain ile URL öneki arasındaki fark nedir?
Kanıtladığınız sahiplik ve buna bağlı olarak hangi URL'lerin doğrulanmış sayılacağı. Domain, sahibi olduğunuz veya kontrol ettiğiniz bir sunucudaki medya için uygundur; önek ise yalnızca dosya yükleyebildiğiniz bir sunucudaki bir klasör için uygundur. TikTok'un her mülk türü için kuralları:
| 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 |
Bir mülk nasıl doğrulanır?
app_id ve secret ile kimlik doğrulayan, hesap token'ı yerine geliştirici uygulamasının bilgilerini kullanan iki çağrı üzerinden; kanıt bu iki çağrının arasına yerleştirilir:
- Ekleyin:
url_property_metaiçindeproperty_typeve url ile POST /business/property/add/; yanıt signature değerini, önek için ayrıcafile_namedeğerini veproperty_status0 değerini verir. - Kanıtlayın: imzayı domain için bir DNS TXT kaydına veya önek için altında, tek bir .txt uzantısıyla adlandırılmış herkese açık bir dosyaya (
file_name) yerleştirin. - Kontrol edin: aynı
url_property_metaile POST /business/property/verify/;property_status1 doğrulandı, 2 ise denemenin başarısız olduğu anlamına gelir.
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_nameMülkleri nasıl listeler veya kaldırırsınız?
app_id ve secret ile GET /business/property/list/ çağrısı, her girişinde property_type, url, property_status, signature ve file_name bulunan url_property_info_list döndürür. Doğrulanmış bir domain'in alt alan adları kendi çağrısı olmadan doğrulanmış sayılır, ancak yalnızca eklenmişlerse listede görünür. app_id, secret ve url_property_meta ile POST /business/property/delete/, uygulamanın artık sahip olmadığı veya kontrol etmediği bir mülkü kaldırır.
URL yerine dosya yükleyebilir misiniz?
Gönderiler için hayır. Accounts API, taslaklar dahil, yalnızca URL'lerden yayınlar; tek yükleme uç noktası olan /business/comment/image/upload/, bir yorum görselini çok parçalı form verisi olarak kabul eder: JPG, JPEG, WebP veya PNG, en fazla 5 MB; bir yorum veya yanıt için bir image_uri döndürür. Parça parça dosya yükleme, developers.tiktok.com üzerindeki Content Posting API'ye aittir; bu, kendi uygulamaları olan ayrı bir API'dir ve aktarım yöntemi FILE_UPLOAD olarak adlandırılır.
Doğrulanmamış bir URL ile ne olur?
TikTok ondan yayınlamayı reddeder. API for Business referansı video ve fotoğraflar için kuralı belirtir, ancak bunun için kendi dönüş kodunu vermez; bu nedenle yanıttaki kodu ve mesajı okuyun. developers.tiktok.com üzerindeki Content Posting API aynı durumu HTTP 403 ile url_ownership_unverified olarak adlandırır. Herhangi bir mülk doğrulanmadan video uç noktasını denemek için TikTok, doğrulama gerektirmeyen bir test video URL'si sunar:
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4easyCoexistence medyanızı TikTok'a nasıl ulaştırır?
Kendisine ait tek bir doğrulanmış URL önekiyle: https://easycoexistence.com/api/social/media/. publish_tiktok_post, HTTPS bağlantınızı alır, herhangi bir şey gönderilmeden önce http:// bağlantılarını reddeder ve TikTok'a bu önek altında bir bağlantı verir; bu bağlantı dosyanızı adlandıran, 6 saat sonra sona eren ve dosyanızın uzantısını koruyan imzalı bir token içerir. TikTok dosyayı getirdiğinde easyCoexistence token'ı denetler, bağlantınızın herkese açık bir adreste HTTPS kullandığını doğrular ve dosyayı, range istekleri ve yönlendirmeler dahil, doğrudan bağlantınızdan saklamadan aktarır. Bağlantınız başarısız olursa TikTok dosyayı indiremez ve gönderi başarısız olur.
Your link: https://cdn.example.com/videos/launch.mp4
Sent to TikTok: https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4Yaygın hatalar
- Bir alt alan adını doğrulayıp dosyaları üst alan adında barındırmak. Doğrulanmış video.example.com kendi alt alan adlarını kapsar, example.com'un kendisini değil.
- Önekin imza dosyasını bir yönlendirme üzerinden sunmak. TikTok bir URL öneki için yönlendirmeleri takip etmez ve 3xx yanıtını geçersiz sayar.
- İmza dosyasını name.txt.txt olarak kaydetmek. TikTok, dosya adının file_name ile eşleşmesini ve tek bir .txt uzantısı olmasını ister.
- Yayınlama çağrısından hemen sonra dosyayı silmek. TikTok dosyayı sonradan, bir saate kadar indirir; bağlantı çalışmayı bırakırsa gönderiyi başarısız sayar.
Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında; bağlantı ekledikçe düşer. İlk 3 gün ücretsizdir.
Sık sorulan sorular
TikTok neden doğrulanmış medya URL'leri istiyor?
TikTok, video URL'lerinin sahipliğini doğrulamanın telif hakkı içeren içerik ve kullanıcı güvenliğiyle ilgili politikalarına uymasına yardımcı olduğunu söylüyor.
Doğrulanmış bir TikTok domain'i alt alan adlarını kapsar mı?
Evet. Doğrulanmış bir domain'in alt alan adları doğrulanmış sayılır; ancak /business/property/list/ bunları yalnızca eklenmişlerse gösterir.
TikTok'un İşletme API'si bir S3 veya CDN bağlantısından yayınlayabilir mi?
Evet, bağlantı uygulamanın doğruladığı bir domain veya URL önekinin altındaysa; örneğin kontrol ettiğiniz bir bucket veya CDN yolundaki bir önek gibi.
Fotoğraf gönderilerinin de doğrulanmış URL'lere ihtiyacı var mı?
Evet. TikTok'un fotoğraf uç noktası, fotoğraf gönderilerinin doğrulanmamış fotoğraf URL'lerinden yayınlanamayacağını belirtir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi