Post Script Yapılandırması

Bu sayfa, görev oluşturmada kullanılan post scriptinin yapılandırma parametrelerini belgeler.

Genel Bakış

post scripti, içeriği (video veya resimler) TikTok veya Instagram'a otomatik olarak yayınlamak için kullanılır. Çeşitli yayınlama yöntemlerini, materyal kaynaklarını ve ses seçeneklerini destekler.

İstek Parametreleri

Bir görev oluştururken, aşağıdaki üst düzey parametreleri belirtebilirsiniz:

Parametre	Tip	Gerekli	Varsayılan	Açıklama
serials	string[]	Koşullu	[]	Cihaz seri numaraları listesi (Mod 1: cihaz tabanlı)
usernames	string[]	Koşullu	[]	Görev oluşturulacak kullanıcı adları listesi (Mod 2: kullanıcı adı tabanlı)
script_name	string	Evet	-	Çalıştırılacak script adı (örn. "post")
script_config	object	Evet	-	Script yapılandırma parametreleri (aşağıya bakın)
enable_multi_account	boolean	Hayır	false	Çoklu hesap modunu etkinleştir (cihazdaki her hesap için görev oluştur)
start_time	string	Hayır	-	"HH:MM" formatında isteğe bağlı başlangıç zamanı
platform	string	Koşullu*	auto	Hedef platform: `tiktok`, `instagram`. Aşağıdaki nota bakın

Not: serials veya usernames parametrelerinden biri sağlanmalıdır.

*Platform Parametresi Davranışı:

TikMatrix ve IgMatrix: platform parametresi sağlanırsa göz ardı edilir. Platform, uygulama adından otomatik olarak belirlenir (TikMatrix → tiktok, IgMatrix → instagram).
TikMatrix Pro: platform parametresi gereklidir ve açıkça tiktok veya instagram olarak belirtilmelidir.

Script Yapılandırması (`script_config`)

script_config nesnesi, post scripti için parametreleri içerir. Aşağıda mevcut parametreler bulunmaktadır:

Ortak Parametreler (TikTok ve Instagram)

Parametre	Tip	Gerekli	Varsayılan	Açıklama
content_type	integer	Hayır	0	İçerik türü: `0` = Video, `1` = Resimler
image_count	integer	Hayır	1	Seçilecek resim sayısı (content_type = 1 olduğunda)
captions	string	Hayır	""	Gönderi için başlık metni. Spintax formatını destekler: `{seçenek1\|seçenek2\|seçenek3}`
caption_format	string	Hayır	"multiline"	Çok satırlı altyazıları işleme yöntemi: `multiline` (gerçek yeni satır ekler) veya `singleline` (`\n` yerine boşluk koyar)
ai_label	boolean	Hayır	false	Gönderiye yapay zeka tarafından oluşturulmuş içerik etiketi eklenip eklenmeyeceği
save_draft	boolean	Hayır	false	Gönderiyi hemen yayımlamak yerine taslak olarak kaydet
post_way	string	Hayır	"addButton"	Gönderi yöntemi. Ayrıntılar için aşağıdaki Gönderi Yöntemleri bölümüne bakın
material_source	string	Hayır	"materialLibrary"	Materyal kaynağı: `materialLibrary` veya `localFolder` (material_list sağlanırsa yok sayılır)
material_path	string	Koşullu	""	Yerel klasör yolu (material_source = "localFolder" olduğunda gerekli)
material_list	string[]	Hayır	[]	Doğrudan materyal dosya yolları dizisi. Sağlandığında, material_source ve material_path mantığını atlar. API otomasyonu için idealdir.
materials_tags	string	Hayır	""	Kütüphaneden filtreleme için virgülle ayrılmış materyal etiketleri
upload_wait_time	integer	Hayır	10	Yükleme tamamlanması için beklenecek saniyeler

upload_wait_time hem normal paylaşım hem de save_draft modu için geçerlidir. Taslak olarak kaydedildiğinde bile TikTok/Instagram'un videoyu arka planda yüklemeyi tamamlaması için zamana ihtiyacı vardır. | sound_wait_time | integer | Hayır | 10 | Ses yüklemesi için beklenecek saniyeler | | add_sound | string/integer | Hayır | "-1" | Ses seçeneği: -1 = varsayılan, 0 = devre dışı, 1 = etkinleştir, custom = özel ses kullan | | sound_name | string | Koşullu | "" | Ses adı/URL (post_way = "useSound" olduğunda gerekli) | | custom_sound_keyword | string | Koşullu | "" | Özel ses aramak için anahtar kelime (add_sound = "custom" olduğunda gerekli) | | origin_sound_volume | integer | Hayır | 100 | Orijinal ses seviyesi (0-100) | | add_sound_volume | integer | Hayır | 100 | Eklenen ses seviyesi (0-100) |

Gönderi Yöntemleri (`post_way`)

post_way parametresi, betiğin paylaşım ekranını nasıl açacağını kontrol eder:

Değer	Açıklama
`addButton`	(Varsayılan) Uygulama içindeki "+" oluşturma düğmesine dokunur, ardından cihaz galerisinden medya seçer. Tüm yerleşimlerle (`reel`, `story`, `post`) çalışır. Çoğu durum için önerilir.
`share`	Medya dosyasından Instagram/TikTok uygulamasına doğrudan bir Android paylaşım intent'i tetikler. Uygulama içi gezinmeyi atlayan alternatif bir yöntemdir; `addButton` akışı belirli bir cihazda veya uygulama sürümünde güvenilir olmadığında kullanışlıdır.
`useSound`	Önce belirli bir ses parçasına gider (`sound_name` URL'si veya anahtar kelimesi üzerinden), ardından videoyu bu sese bağlar. Yalnızca Reels / TikTok için. `sound_name` ayarlanmış olmalıdır. `placement = "post"` veya `placement = "story"` ile uyumlu değildir.

not

placement post olduğunda (Instagram akış gönderisi), post_way ne olursa olsun ses otomasyonu desteklenmez. Betik ses adımını otomatik olarak atlar.

TikTok'a Özgü Parametreler

Parametre	Tip	Gerekli	Varsayılan	Açıklama
placement	string	Hayır	""	Yayınlama konumu: `""` (normal video, varsayılan) veya `"story"` (TikTok Story). `"story"` ile script, ses kurulumundan sonra "Your Story" düğmesine tıklar ve başlık/ürün bağlantısı/AI etiketi adımlarını atlar.
add_product_link	integer	Hayır	0	Ürün/alışveriş bağlantısı eklenip eklenmeyeceği: `0` = hayır, `1` = evet

Instagram'a Özgü Parametreler

Parametre	Tip	Gerekli	Varsayılan	Açıklama
placement	string	Hayır	"reel"	Gönderi yerleşimi: `reel` (Reels), `story` (Stories) veya `post` (normal akış gönderisi). Not: `placement` `post` olduğunda ses seçenekleri desteklenmez
enable_schedule_reels	boolean	Hayır	false	Reel'in gelecekteki bir zamana planlanıp planlanmayacağı
schedule_reels_time	string	Koşullu	""	`YYYY-MM-DD HH:MM` biçiminde zamanlanmış yayın tarihi (enable_schedule_reels = true olduğunda gerekli)
story_link	string	Hayır	""	Story'ye çıkartma bağlantısı olarak eklenecek URL (yalnızca placement = "story" olduğunda geçerlidir)

Örnekler

TikTok Story Yayınlama

Doğrudan TikTok Story olarak yayınlayın. Ses kurulumundan sonra script "Your Story" düğmesine tıklar — başlık/ürün bağlantısı/AI etiketi adımları yok :

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "placement": "story",
      "post_way": "addButton",
      "material_list": ["C:/Videos/story_video.mp4"],
      "upload_wait_time": 30
    }
  }'

Doğrudan Materyal Listesiyle Temel Gönderi Görevi

Bu, API otomasyonu için önerilen yaklaşımdır - materyal kütüphanesine veya klasör taramasına güvenmeden materyal yollarını doğrudan iletin:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Yeni videoma göz atın! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Materyal Kütüphanesi ile Gönderi Görevi (TikTok)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1", "device_serial_2"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Yeni videoma göz atın! #viral #fyp",
      "post_way": "addButton",
      "material_source": "materialLibrary",
      "materials_tags": "trending, dance",
      "upload_wait_time": 60,
      "add_sound": "-1"
    },
    "enable_multi_account": false
  }'

Kullanıcı Adı Listesine Göre Gönderi Görevi

Bu mod, cihaz seri numaralarını bilmeden doğrudan belirli hesaplar için görevler oluşturmanıza olanak tanır:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["@user1", "@user2", "@user3"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Yeni videoma göz atın! #viral #fyp",
      "material_list": [
        "C:/Videos/video1.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Yerel Klasör ile Gönderi Görevi (Instagram)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Harika içerik! #instagram #reels",
      "post_way": "addButton",
      "placement": "reel",
      "material_source": "localFolder",
      "material_path": "C:/Videos/instagram",
      "upload_wait_time": 45
    },
    "enable_multi_account": true
  }'

Instagram akış gönderisi (placement: post)

Normal Instagram akışına (Reel değil) paylaşın. Bu yerleşimde ses seçenekleri desteklenmez:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "New post! #instagram",
      "placement": "post",
      "post_way": "addButton",
      "material_list": ["C:/Videos/my_video.mp4"],
      "upload_wait_time": 45
    }
  }'

Özel Ses ile Gönderi

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 0,
      "captions": "Bu trend sese dans ediyorum!",
      "post_way": "addButton",
      "add_sound": "custom",
      "custom_sound_keyword": "trending dance 2024",
      "origin_sound_volume": 30,
      "add_sound_volume": 70,
      "material_source": "materialLibrary",
      "upload_wait_time": 60
    }
  }'

Belirli Ses URL'si Kullanarak Gönderi

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "post_way": "useSound",
      "sound_name": "https://www.tiktok.com/music/original-sound-7123456789",
      "captions": "Bu harika sesi kullanıyorum!",
      "material_source": "materialLibrary"
    }
  }'

Resim Gönderisi (Carousel)

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "script_config": {
      "content_type": 1,
      "image_count": 5,
      "captions": "Bu fotoğraflara göz atın! #photocarousel",
      "material_source": "localFolder",
      "material_path": "C:/Images/carousel",
      "upload_wait_time": 45
    }
  }'

Açık Platform Seçimi ile Gönderi

platform parametresini kullanarak hedef platformu açıkça belirtebilirsiniz. Bu, ortam varsayılanını geçersiz kılmak istediğinizde kullanışlıdır:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "post",
    "platform": "instagram",
    "script_config": {
      "content_type": 0,
      "captions": "Instagram'a gönderiyorum! #instagram #reels",
      "placement": "reel",
      "material_list": [
        "C:/Videos/instagram_video.mp4"
      ],
      "upload_wait_time": 60
    }
  }'

Yanıt

{
  "code": 0,
  "message": "success",
  "data": {
    "task_ids": [101, 102],
    "created_count": 2
  }
}

Ayrıca Bakınız

Görev Yönetimi API'si - Görev oluşturma, listeleme ve yönetme

Genel Bakış​

İstek Parametreleri​

Script Yapılandırması (script_config)​

Ortak Parametreler (TikTok ve Instagram)​

Gönderi Yöntemleri (post_way)​

TikTok'a Özgü Parametreler​

Instagram'a Özgü Parametreler​

Örnekler​

TikTok Story Yayınlama​

Doğrudan Materyal Listesiyle Temel Gönderi Görevi​

Materyal Kütüphanesi ile Gönderi Görevi (TikTok)​

Kullanıcı Adı Listesine Göre Gönderi Görevi​

Yerel Klasör ile Gönderi Görevi (Instagram)​

Instagram akış gönderisi (placement: post)​

Özel Ses ile Gönderi​

Belirli Ses URL'si Kullanarak Gönderi​

Resim Gönderisi (Carousel)​

Açık Platform Seçimi ile Gönderi​

Yanıt​

Ayrıca Bakınız​