API ile bir TikTok içerik üreticisinin taslaklarına video gönderme
TikTok'un API'leri bir videoyu içerik üreticisinin taslaklarına yükleme akışıyla gönderir: Content Posting API'nin /v2/post/publish/inbox/video/init/ uç noktası videoyu video.upload kapsamıyla yükler ve TikTok, içerik üreticisine uygulamada düzenleyip yayınlaması için bir gelen kutusu bildirimi gönderir. API for Business aynısını /business/video/publish/ üzerinde upload_to_draft ile, fotoğraf gönderilerinde ise is_draft ile yapar.
easyCoexistence, TikTok videolarını ve fotoğraf gönderilerini publish_tiktok_post ile Claude, ChatGPT veya kendi platformunuzdan yayınlar; hemen veya 90 güne kadar ileri bir tarih ve saatte, her sıraya alınan gönderi yola çıkana kadar Gönderiler ekranında görünür.
TikTok'un, içeriği üreticinin hesabına TikTok'ta düzenlenip yayınlanmak üzere taslak olarak paylaşması diye tanımladığı kapsam.
Content Posting API'nin, TikTok'un spamı azaltmak için koyduğu sınır olarak herhangi bir 24 saatlik dönemde izin verdiği en fazla bekleyen paylaşım sayısı.
/business/publish/status/ durumu, taslak yüklendikten ve TikTok içerik üreticisinin gelen kutusuna bildirim gönderdikten sonra raporlar.
Her kullanıcı erişim token'ının Content Posting API'nin yükleme uç noktasına gönderebileceği istekler.
upload_to_draft true olduğunda /business/video/publish/ üzerindeki diğer post_info alanlarının ne olacağı.
Taslak, doğrudan gönderiden nasıl ayrılır?
Yayınla düğmesine kimin bastığında. Doğrudan gönderi, TikTok işlemeyi bitirdikten sonra yayına girer; taslak ise içerik üreticisinin TikTok gelen kutusuna düşer ve yalnızca üretici onu açıp dilediği gibi düzenleyip yayınladığında yayımlanır. Fark, TikTok'un iki yayın API'sinin de içinden geçer:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Content Posting API bir taslağı nasıl yükler?
https://open.tiktokapis.com/v2/post/publish/inbox/video/init/ adresine, video.upload kapsamını taşıyan bir kullanıcı erişim token'ıyla ve bir source_info nesnesiyle POST isteği gönderilerek. PULL_FROM_URL, TikTok'un uygulamanın doğruladığı bir alan adı veya URL öneki üzerinden videoyu çekmesini sağlar; FILE_UPLOAD bir upload_url döndürür ve dosya bu adrese PUT istekleriyle parça parça gönderilir. Dönen publish_id, /v2/post/publish/status/fetch/ uç noktasına verilir; fotoğraflar post_mode değeri MEDIA_UPLOAD olarak ayarlanmış /v2/post/publish/content/init/ uç noktasını kullanır ve TikTok, düzenlemeye TikTok'ta devam etmek için kullanıcıya gelen kutusu bildirimini açmasını söylemesini uygulamalardan ister:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Content Posting API taslakları hangi sınırlara tabidir?
TikTok bunları yükleme başvuru dokümanında belgeler; her biri geçerli olduğunda başlatma çağrısı tarafından döndürülür:
- Bekleyen taslaklar: herhangi bir 24 saatlik dönemde en fazla 5 bekleyen paylaşım; bu sınır aşıldığında HTTP 403 ile
spam_risk_too_many_pending_share. - İstekler: kullanıcı erişim token'ı başına dakikada 6; ardından HTTP 429 ile
rate_limit_exceeded. - Kapsam: video.upload içermeyen bir token, HTTP 401 ile
scope_not_authorizedalır. - Medya: uygulamanın doğrulamadığı bir alan adı veya önekten
PULL_FROM_URL, HTTP 403 ileurl_ownership_unverifiedalır.
API for Business taslağı nasıl yükler?
Yayın uç noktalarıyla ve post_info içinde bir alan daha ekleyerek. /business/video/publish/ üzerinde upload_to_draft true olarak ayarlanırsa video taslak olarak gönderilir ve TikTok post_info'nun diğer alanlarını yok sayar; /business/photo/publish/ üzerinde is_draft yalnızca başlık ve açıklamayı tutar. İkisi de hesabın token'ında video.upload gerektirir; bunu /tt_user/token_info/get/ listeler. Bu kapsam yoksa hesap sahibi uygulamayı yeniden yetkilendirerek taslak yüklemeyi onaylar. Medya yine doğrulanmış bir URL'de durur, durum SEND_TO_USER_INBOX olarak okunur ve içerik üreticisi taslağı gelen kutusu bildirimi üzerinden bulur:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'İçerik üreticisi taslakla ne yapar?
TikTok'ta tamamlar. Gelen kutusu bildirimi, yüklenen videoyu veya fotoğrafları TikTok'un düzenleyicisinde açar; üretici burada inceler, düzenler ve yayınlar. Content Posting API'de, üretici taslaktan gönderiyi yayınladığında durum SEND_TO_USER_INBOX durumundan PUBLISH_COMPLETE durumuna geçer; TikTok ayrıca tek bir taslağın birden fazla gönderi üretebileceğini belirtir.
easyCoexistence taslak gönderiyor mu?
Hayır: publish_tiktok_post yayınlar. Bu fonksiyon upload_to_draft veya is_draft olmadan /business/video/publish/ veya /business/photo/publish/ çağırır; dolayısıyla gönderi TikTok işlemeyi bitirdiğinde yayına girer. Bir gönderiyi incelemek için geri tutmak istiyorsanız, scheduled_at ile 1 dakika ile 90 gün sonra arasında zamanlayın: gönderi Gönderiler ekranındaki Coming up bölümünde bekler, update_scheduled_post zamanını, açıklamayı veya fotoğraf gönderisinin başlığını değiştirir ve cancel_scheduled_post yayına çıkmadan önce durdurur.
Yaygın hatalar
- Taslak göndermek için video.publish istemek. Taslaklar video.upload gerektirir; TikTok bu kapsamı içeriği taslak olarak paylaşmak diye tanımlar.
- API for Business üzerinden bir video taslağına açıklama eklemek. upload_to_draft true olduğunda TikTok post_info'nun geri kalanını yok sayar.
- Taslakları üreticiler gönderiden daha hızlı yüklemek. Content Posting API, 24 saatte 5 bekleyen paylaşımda durur ve spam_risk_too_many_pending_share döndürür.
- Kullanıcıları gelen kutusuna yönlendirmeden bırakmak. TikTok, uygulamalardan gönderiyi tamamlamak için gelen kutusu bildirimini açmalarını söylemelerini ister.
Bağlantı başına aylık US$ 9'dan US$ 0.75'e kadar, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz.
Sık sorulan sorular
TikTok API'si bir videoyu taslak olarak kaydedebilir mi?
Evet. Yükleme akışı videoyu içerik üreticisinin TikTok gelen kutusuna koyar; üretici orada düzenleyip yayınlar. Token'ın video.upload kapsamına sahip olması gerekir.
API üzerinden gönderilen taslak nerede görünür?
TikTok uygulamasında; videoyu TikTok'un düzenleyicisinde açan bir gelen kutusu bildirimi arkasında, üretici işi tamamlasın diye.
Bir TikTok taslağı açıklamamı koruyabilir mi?
API for Business'ta fotoğraf taslağı başlığını ve açıklamasını korur; video taslağı ise post_info'nun diğer alanlarını düşürür.
Tek bir TikTok taslağı birden fazla gönderi olabilir mi?
Evet. TikTok, tek bir taslağın birden fazla gönderi üretebileceğini belirtir; Content Posting API'de üretici o taslaktan yayınladığında durum PUBLISH_COMPLETE olur.
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