Lewati ke konten utama

Gambaran Umum API Lokal

Pembaruan skrip\nThreads di Pro mendukung message, follow_back, scrape_users, dan repost; content_type = 2 pada post berarti posting teks saja. Message mandiri tidak tersedia di TikTok/Instagram; gunakan Super Marketing.\n:::

TikMatrix menyediakan RESTful API lokal yang memungkinkan Anda mengelola tugas secara terprogram. Ini sangat berguna untuk mengintegrasikan TikMatrix ke dalam sistem otomasi Anda sendiri, membangun alur kerja kustom, atau membuat operasi batch.

Persyaratan​

Persyaratan Lisensi

API Lokal hanya tersedia untuk pengguna paket Pro, Team, dan Business. Paket Starter tidak menyediakan akses API.

Base URL​

API berjalan secara lokal di:

http://localhost:50809/api/v1/
catatan

Port 50809 adalah port default. Pastikan TikMatrix sedang berjalan sebelum mengirim permintaan.

Format Response​

Semua response API mengikuti format berikut:

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

Penjelasan Kode Response​

CodeDeskripsi
0Sukses
40001Permintaan Buruk - Parameter tidak valid, termasuk script_config yang gagal validasi
40002Kesalahan parameter - script_name tidak ada
40003Permintaan Buruk - Skrip tidak didukung pada build atau platform ini, tidak memiliki implementasi, atau status tugas tidak valid
40004Kesalahan parameter - Hanya tugas yang sedang berjalan yang dapat dihentikan
40005Kesalahan parameter - task_ids tidak dapat kosong
40301Terlarang - Akses API memerlukan paket Pro+
40401Tidak ditemukan - Resource tidak ada
50001Kesalahan internal server

Memulai Cepat​

1. Periksa Akses API​

Pertama, konfirmasi apakah lisensi Anda mendukung API:

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

Contoh response:

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

2. Menemukan skrip dan parameternya​

GET /api/v1/schema menjelaskan setiap skrip yang dapat dijalankan build ini beserta field script_config yang tepat: nama, tipe, nilai bawaan, nilai yang diizinkan, dan mana yang wajib. Ia dihasilkan dari katalog yang sama dengan yang dipakai server untuk validasi, sehingga tidak bisa menyimpang dari apa yang diterima saat pembuatan tugas.

curl http://localhost:50809/api/v1/schema

Dua parameter kueri opsional:

ParameterEfek
platformMembatasi daftar ke tiktok, instagram atau threads. Platform yang tidak disertakan build ini ditolak dengan 40001. Bawaannya semua platform yang disertakan build.
include_unavailableJika true, juga menampilkan nama skrip yang diterima API tetapi tidak memiliki implementasi yang berfungsi. Masing-masing membawa unavailable_reason.

Respons (diringkas):

{
  "code": 0,
  "message": "success",
  "data": {
    "build": { "platforms": ["tiktok"] },
    "scripts": [
      {
        "name": "follow",
        "internal_name": "follow",
        "summary": "Follow the given users. One task per target.",
        "platforms": ["tiktok", "instagram", "threads"],
        "available": true,
        "fan_out": { "kind": "per_item", "key": "target_users", "alt_key": "target_user" },
        "any_of": [["target_users", "target_user"]],
        "fields": [
          {
            "key": "access_method",
            "type": "string",
            "required": false,
            "default": "direct",
            "choices": ["direct", "search"],
            "description": "How to reach the profile: direct (via URL) or search."
          }
        ]
      }
    ]
  }
}

fan_out memberi tahu berapa tugas yang akan dihasilkan sebuah permintaan: per_device membuat satu tugas per perangkat (atau per akun dalam mode multi-akun), per_item membuat satu per entri field yang disebut, per perangkat.

3. Membuat Tugas​

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": "Lihat video baru saya! #trending"
    },
    "enable_multi_account": false
  }'

4. Query Daftar Tugas​

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

Script yang Tersedia​

Parameter script_name menerima nilai-nilai berikut:

Nama ScriptDeskripsiDukungan API
postPublikasikan video, gambar, atau postingan teks saja untuk Threads✅ Didukung
followIkuti pengguna✅ Didukung
unfollowBerhenti mengikuti pengguna✅ Didukung
account_warmupLakukan pemanasan akun✅ Didukung
commentKirim komentar baru pada postingan✅ Didukung
boost_commentSuka/balas komentar yang sudah ada✅ Didukung
loginMasuk ke akun✅ Didukung
profilePerbarui profil✅ Didukung
match_accountCocokkan akun di perangkat✅ Didukung
likeSuka pada postingan✅ Didukung
viewTonton postingan selama durasi tertentu✅ Didukung
favoriteSimpan postingan ke Favorit✅ Didukung
repostRepost video TikTok atau postingan Threads✅ Didukung — TikTok dan Threads
messageKirim pesan langsung✅ Didukung — hanya Threads
follow_backIkuti akun dari daftar pengikut✅ Didukung — TikTok, Instagram dan Threads
follow_suggestedIkuti akun yang disarankan✅ Didukung — hanya TikTok
custom_scriptJalankan program yang Anda daftarkan sendiri✅ Didukung ‡
super_marketingKampanye super marketing✅ Didukung †
scrape_usersEkspor username pengikut, yang diikuti, atau hasil pencarian✅ Didukung — TikTok, Instagram dan Threads
auto_replyBalas pesan langsung dan komentar❌ Tidak melalui API §
† Super marketing menggunakan titik akhir khusus

Kampanye super marketing tidak dibuat melalui POST /api/v1/task. Kampanye ini berjalan dari kumpulan data target yang dapat digunakan ulang dan memiliki titik akhir sendiri — lihat Konfigurasi Script Super Marketing.

Pesan langsung khusus Threads

Task message yang berdiri sendiri menjalankan alur profil Threads → Message. Untuk TikTok dan Instagram, gunakan super_marketing dengan kumpulan data target sebagai gantinya.

Script khusus platform

repost diimplementasikan untuk TikTok dan Threads; follow_suggested tetap khusus TikTok. follow_back dan scrape_users menggunakan UI pengikut/pencarian pada perangkat nyata di tiap platform dan tersedia di TikTok, Instagram dan Threads.

‡ Skrip kustom harus didaftarkan terlebih dahulu

custom_script menjalankan program yang Anda daftarkan di Perangkat → Skrip Kustom. Berikan ID-nya di script_config.custom_script_id — lihat Skrip Kustom.

§ Balas Otomatis berjalan dari halamannya sendiri

auto_reply membalas pesan langsung dan komentar di TikTok, Instagram dan Threads, pada paket Pro dan yang lebih tinggi. Putarannya dijadwalkan oleh halaman Balas Otomatis di aplikasi, yang memuat aturan balasan, jam kerja, dan sakelar jeda, sehingga tidak dapat dibuat melalui POST /api/v1/task.

Validasi script_config​

Pembuatan tugas memvalidasi script_config terhadap skema di atas sebelum menulis apa pun, sehingga parameter yang salah kembali sebagai 400 yang menyebut field-nya, bukan tugas yang gagal di ponsel belakangan. Tiga hal ditolak:

  • field wajib yang hilang atau kosong,
  • grup salah-satu yang tidak satu pun anggotanya diisi (misalnya follow butuh salah satu dari target_users / target_user),
  • nilai di luar choices yang terdokumentasi untuk sebuah field.

Kunci yang tidak terdaftar di skema diabaikan, bukan ditolak — aplikasi desktop meneruskan kuncinya sendiri lewat objek yang sama, dan menolak kunci tak dikenal akan merusak integrasi yang ada. Semuanya dicatat di sisi server sehingga salah ketik bisa Anda temukan di log aplikasi.

Angka boleh dikirim sebagai string ("20" maupun 20), sesuai dengan yang sudah diterima skrip.

Status Tugas​

Kode StatusTeks StatusDeskripsi
0pendingTugas menunggu eksekusi
1runningTugas sedang dieksekusi
2completedTugas berhasil dieksekusi
3failedTugas gagal dieksekusi

Selanjutnya​