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}
post_way	string	Hayır	"share"	Yayınlama yöntemi: share, addButton veya useSound
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	30	Yükleme tamamlanması için beklenecek saniyeler
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	50	Orijinal ses seviyesi (0-100)
add_sound_volume	integer	Hayır	50	Eklenen ses seviyesi (0-100)

TikTok Özel Parametreler

Parametre	Tip	Gerekli	Varsayılan	Açıklama
add_product_link	integer	Hayır	0	Ürün bağlantısı ekle: 0 = Hayır, 1 = Evet

Instagram Özel Parametreler

Parametre	Tip	Gerekli	Varsayılan	Açıklama
placement	string	Hayır	"reel"	Gönderi konumu: reel veya story

Örnekler

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
  }'

Ö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