Ana içeriğe geç

Yerel API Genel Bakış

TikMatrix, görevleri programatik olarak yönetmenizi sağlayan yerel bir RESTful API sunar. Bu, TikMatrix'i kendi otomasyon sistemlerinizle entegre etmek, özel iş akışları oluşturmak veya toplu işlemler gerçekleştirmek için kullanışlıdır.

Gereksinimler​

Lisans Gereksinimi

Yerel API yalnızca Pro, Team ve Business plan abonelerine açıktır. Starter plan API erişimine sahip değildir.

Temel URL​

API yerel makinenizde çalışır:

http://localhost:50809/api/v1/
not

50809 varsayılan porttur. API istekleri göndermeden önce TikMatrix'in çalıştığından emin olun.

Yanıt Formatı​

Tüm API yanıtları şu formatı takip eder:

{
  "code": 0,
  "message": "success",
  "data": { ... }
}

Yanıt Kodları​

CodeAçıklama
0Başarılı
40001Hatalı İstek - Geçersiz parametreler
40002Hatalı İstek - script_name eksik
40003Hatalı İstek - Skript desteklenmiyor veya geçersiz görev durumu
40004Hatalı İstek - Yalnızca çalışan görevler durdurulabilir
40005Hatalı İstek - task_ids boş olamaz
40301Yasak - API erişimi Pro+ planı gerektirir
40401Bulunamadı - Kaynak bulunamadı
50001Dahili Sunucu Hatası

Hızlı Başlangıç​

1. API Erişimini Kontrol Et​

Önce lisansınızın API erişimini destekleyip desteklemediğini doğrulayın:

curl http://localhost:50809/api/v1/license/check

Yanıt:

{
  "code": 0,
  "message": "success",
  "data": {
    "plan_name": "Pro",
    "api_enabled": true,
    "device_limit": 20,
    "message": "API access enabled"
  }
}

2. Görev Oluştur​

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": 1,
      "captions": "Yeni videoma göz at! #viral"
    },
    "enable_multi_account": false,
    "start_time": "14:30"
  }'

3. Görevleri Listele​

curl http://localhost:50809/api/v1/task?status=0&page=1&page_size=20

Mevcut Skriptler​

script_name parametresi aşağıdaki değerleri kabul eder:

Script AdıAçıklamaAPI Desteği
postİçerik yayınla✅ Destekleniyor
followKullanıcıları takip et✅ Destekleniyor
unfollowTakibi bırak✅ Destekleniyor
account_warmupHesapları ısıt✅ Destekleniyor
commentGönderilere yorum yap✅ Destekleniyor
boost_commentMevcut yorumları beğen/yanıtla✅ Destekleniyor
loginHesaba giriş yap✅ Destekleniyor
profileProfili güncelle✅ Destekleniyor
match_accountCihazda hesapları eşleştir✅ Destekleniyor
likeBeğen✅ Destekleniyor
viewBir gönderiyi belirli bir süre izle✅ Destekleniyor
favoriteGönderiyi Favorilere kaydet✅ Destekleniyor
repostTikTok videolarını yeniden paylaş✅ Destekleniyor
messageDoğrudan mesaj gönder✅ Destekleniyor
follow_suggestedÖnerilen hesapları takip et✅ Destekleniyor
super_marketingSüper pazarlama kampanyası✅ Destekleniyor †
scrape_userKullanıcı verisi çek🔜 Yakında
† Süper marketing özel endpoint'ler kullanır

Süper pazarlama kampanyası POST /api/v1/task üzerinden oluşturulmaz. Yeniden kullanılabilir bir hedef veri setine dayanır ve kendine özgü endpoint'leri vardır — bkz. Süper Marketing Skript Yapılandırması.

Görev Durumu​

Durum KoduDurum MetniAçıklama
0pendingGörev yürütülmeyi bekliyor
1runningGörev şu anda çalışıyor
2completedGörev başarıyla tamamlandı
3failedGörev başarısız oldu

Sonraki Adımlar​