Görev Yönetimi API'si

Bu sayfa, TikMatrix'te görevleri yönetmek için kullanılabilecek tüm API uç noktalarını belgeler.

Görev Oluştur

Bir veya daha fazla cihaz veya kullanıcı adı için yeni bir görev oluşturun.

• Uç Nokta: POST /api/v1/task
• Content-Type: application/json

İstek Parametreleri

API, görev oluşturmak için iki mod destekler:

Mod 1: Cihaz tabanlı - Cihazlar için görev oluşturmak üzere serials kullanın Mod 2: Kullanıcı adı tabanlı - Belirli hesaplar için doğrudan görev oluşturmak üzere usernames kullanın

Parametre	Tür	Gerekli	Açıklama
serials	string[]	Koşullu	Cihaz seri numaraları dizisi (usernames sağlanmamışsa gereklidir)
usernames	string[]	Koşullu	Görev oluşturulacak kullanıcı adları dizisi (serials sağlanmamışsa gereklidir). Sağlandığında, görevler doğrudan bu hesaplar için oluşturulur.
script_name	string	Evet	Çalıştırılacak betiğin adı
script_config	object	Evet	Betik için yapılandırma parametreleri (betiğe özgü belgelere bakın)
enable_multi_account	boolean	Hayır	Çoklu hesap modunu etkinleştirir (varsayılan: false). Yalnızca cihaz tabanlı modda geçerlidir.
start_time	string	Hayır	"HH:MM" biçiminde zamanlanmış başlangıç saati
close_app	boolean	Hayır	Görev bittikten sonra hedef uygulamanın kapatılıp kapatılmayacağı (zorla durdurulup durdurulmayacağı) (varsayılan: true). Görev tamamlandıktan sonra uygulamayı açık bırakmak için false olarak ayarlayın.
platform	string	Hayır	Hedef platform (tiktok veya instagram). Yalnızca TikMatrix Pro tarafından kullanılır; tek platformlu sürümlerde göz ardı edilir.
force	boolean	Hayır	Auto WakeUp Agent (uiautomator) hazır olma korumasını atlar (varsayılan: false). Agent Ayarlar'da devre dışı bırakıldığında, force true olmadıkça görev oluşturma 40006 hatasıyla reddedilir — bu, masaüstü arayüzündeki "Yine de Devam Et" seçeneğini yansıtır.

Desteklenen Betikler

Betik Adı	Açıklama	Belgeler
post	TikTok/Instagram'a video veya görsel yayınla	Post Betik Yapılandırması
follow	Kullanıcıları takip et veya takipten çık	Follow Betik Yapılandırması
unfollow	Kullanıcıları takipten çık	Unfollow Betik Yapılandırması
account_warmup	Hesapları ısıt	Account Warmup Betik Yapılandırması
comment	Gönderilere yeni yorum gönder	Comment Betik Yapılandırması
boost_comment	Mevcut yorumları beğen / yanıtla	Boost Comment (Reply) Betik Yapılandırması
login	Hesaba giriş yap	Login Betik Yapılandırması
profile	Profili güncelle	Profile Betik Yapılandırması
match_account	Cihazdaki hesapları eşleştir	Match Account Betik Yapılandırması
like	Gönderileri beğen	Like Betik Yapılandırması
view	Bir gönderiyi belirli bir süre izle	View Betik Yapılandırması
favorite	Bir gönderiyi Favorilere kaydet	Favorite Betik Yapılandırması
repost	TikTok videolarını yeniden paylaş	Repost Betik Yapılandırması
message	Direkt mesaj gönder	Message Betik Yapılandırması
follow_suggested	Önerilen hesapları takip et	Follow Suggested Betik Yapılandırması

Örnek

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": "Check out my new video! #viral #fyp",
      "material_list": ["C:/Videos/video1.mp4"],
      "upload_wait_time": 60
    }
  }'

Ayrıntılı script_config parametreleri ve daha fazla örnek için Post Betik Yapılandırması ve Follow Betik Yapılandırması sayfalarına bakın.

Bir görevden sonra uygulamayı açık tutma

Varsayılan olarak, hem uygulama içi davranışı yansıtmak hem de cihaz kaynaklarını serbest bırakmak için bir görev bittiğinde hedef uygulama zorla durdurulur. Görev tamamlandıktan sonra uygulamayı çalışır durumda bırakmak için "close_app": false gönderin — görevleri zincirlerken veya sonucu cihazda incelerken 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": "like",
    "script_config": {
      "target_post_url": "https://www.tiktok.com/@user/video/123"
    },
    "close_app": false
  }'

Yanıt

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

Auto WakeUp Agent devre dışı

Auto WakeUp Agent Ayarlar'da kapatıldığında, görev oluşturma varsayılan olarak reddedilir — masaüstü arayüzü uyarısıyla aynı şekilde — çünkü oluşturulan görevler agent yeniden etkinleştirilene kadar hiçbir zaman çalışmaz:

curl -X POST http://localhost:50809/api/v1/task \
  -H "Content-Type: application/json" \
  -d '{
    "serials": ["device_serial_1"],
    "script_name": "like",
    "script_config": { "target_post_url": "https://www.tiktok.com/@user/video/123" }
  }'

{
  "code": 40006,
  "message": "uiautomator (Auto WakeUp Agent) is disabled: created tasks will not execute until it is re-enabled in Settings. Pass \"force\": true to create anyway.",
  "data": null
}

Görevleri yine de oluşturmak için "force": true gönderin (arayüzdeki "Yine de Devam Et" ile eşdeğerdir).

Görevleri Listele

İsteğe bağlı filtrelerle görevleri sorgulayın.

• Uç Nokta: GET /api/v1/task

Parametre	Tür	Gerekli	Açıklama
status	integer	Hayır	Duruma göre filtrele (0=bekliyor, 1=çalışıyor, 2=tamamlandı, 3=başarısız)
serial	string	Hayır	Cihaz seri numarasına göre filtrele
script_name	string	Hayır	Betik adına göre filtrele
source	string	Hayır	Kaynağa göre filtrele ("ui" veya "api")
page	integer	Hayır	Sayfa numarası (varsayılan: 1)
page_size	integer	Hayır	Sayfa başına öğe (varsayılan: 20, maksimum: 100)

Görev Ayrıntılarını Al

Belirli bir görev hakkında ayrıntılı bilgi alın.

• Uç Nokta: GET /api/v1/task/{task_id}

Görevi Sil

Bir görevi silin. Görev çalışıyorsa, önce durdurulacaktır.

• Uç Nokta: DELETE /api/v1/task/{task_id}

Toplu Görev Silme

Birden fazla görevi aynı anda silin. Çalışan görevler önce durdurulacaktır.

• Uç Nokta: DELETE /api/v1/task/batch
• Body: { "task_ids": [1, 2, 3] }

Görevi Durdur

Çalışan bir görevi durdurun.

• Uç Nokta: POST /api/v1/task/{task_id}/stop

Başarısız Görevi Yeniden Dene

Başarısız bir görevi yeniden deneyin.

• Uç Nokta: POST /api/v1/task/{task_id}/retry

Tüm Başarısız Görevleri Yeniden Dene

Tüm başarısız görevleri aynı anda yeniden deneyin.

• Uç Nokta: POST /api/v1/task/retry-all

Görev İstatistiklerini Al

Tüm görevler hakkında istatistikleri alın.

• Uç Nokta: GET /api/v1/task/stats
• Yanıt: toplam, bekleyen, çalışan, tamamlanan ve başarısız sayıları döndürür.

API Lisansını Kontrol Et

Lisansınızın API erişimini destekleyip desteklemediğini kontrol edin.

• Uç Nokta: GET /api/v1/license/check
• Not: Starter planı 40301 hata kodunu döndürür. Pro, Team ve Business planlarının API erişimi vardır.