Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

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.

Nov 16, 2023

Bu tarihten itibaren TikTok, doğrulanmış bir domain'de veya URL önekinde olmayan video URL'lerini kabul etmez.

Oct 15, 2025

Bu tarihten itibaren URL mülk uç noktaları da geliştirici uygulamasının secret'ını gerektirir.

1 / 2

property_type değerleri: domain için 1, URL öneki için 2.

0, 1, 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.

Apr 7, 2023

Bu tarihten önce video yayınlayan geliştiricilerin video URL'lerinin domain'leri otomatik olarak doğrulanmış olarak ayarlandı.

5 MB

/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_failed veya photo_pull_failed hatası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ı:

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

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_meta içinde property_type ve url ile POST /business/property/add/; yanıt signature değerini, önek için ayrıca file_name değerini ve property_status 0 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_meta ile POST /business/property/verify/; property_status 1 doğrulandı, 2 ise denemenin başarısız olduğu anlamına gelir.
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

Mü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:

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

easyCoexistence 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.

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

Yaygı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.
Bunu EasyCoexistence'la yapmak

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