Gambaran Umum API Lokal

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

Code	Deskripsi
0	Sukses
40001	Kesalahan parameter - Parameter permintaan tidak valid
40002	Kesalahan parameter - script_name tidak ada
40003	Kesalahan parameter - Script tidak didukung atau status tugas tidak valid
40004	Kesalahan parameter - Hanya tugas yang sedang berjalan yang dapat dihentikan
40005	Kesalahan parameter - task_ids tidak dapat kosong
40301	Terlarang - Akses API memerlukan paket Pro+
40401	Tidak ditemukan - Resource tidak ada
50001	Kesalahan 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. 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
  }'

3. Query Daftar Tugas

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

Script yang Tersedia

Parameter script_name dapat menerima nilai berikut:

Nama Script	Deskripsi	Dukungan API
post	Posting konten	✅ Didukung
follow	Mengikuti pengguna	✅ Didukung
unfollow	Berhenti mengikuti	✅ Didukung
account_warmup	Pemanasan akun	✅ Didukung
comment	Komentar pada postingan	✅ Didukung
boost_comment	Suka/balas komentar yang ada	✅ Didukung
login	Masuk ke akun	✅ Didukung
profile	Perbarui profil	✅ Didukung
match_account	Cocokkan akun di perangkat	✅ Didukung
like	Suka pada postingan	✅ Didukung
view	Tonton postingan selama durasi tertentu	✅ Didukung
favorite	Simpan postingan ke Favorit	✅ Didukung
repost	Repost video TikTok	✅ Didukung
message	Pesan pribadi	✅ Didukung
follow_suggested	Ikuti akun yang disarankan	✅ Didukung
super_marketing	Kampanye super marketing	✅ Didukung †
scrape_user	Scrape data pengguna	🔜 Segera

† Super marketing menggunakan titik akhir khusus

Kampanye super marketing tidak dibuat melalui POST /api/v1/task. Kampanye ini menggunakan kumpulan data target yang dapat digunakan kembali dan memiliki titik akhir tersendiri — lihat Konfigurasi Skrip Super Marketing.

Status Tugas

Kode Status	Teks Status	Deskripsi
0	pending	Tugas menunggu eksekusi
1	running	Tugas sedang dieksekusi
2	completed	Tugas berhasil dieksekusi
3	failed	Tugas gagal dieksekusi

Selanjutnya

• API Manajemen Tugas - Membuat, query, dan mengelola tugas
• API Log Aktivitas - Lacak dan kelola log aktivitas
• Konfigurasi Script Post - Konfigurasi parameter script post
• Konfigurasi Script Follow - Konfigurasi parameter script follow
• Konfigurasi Skrip Ikuti yang Disarankan - Konfigurasikan parameter skrip ikuti yang disarankan
• Konfigurasi Script Unfollow - Konfigurasi parameter script unfollow
• Konfigurasi Script Account Warmup - Konfigurasi parameter script account warmup
• Konfigurasi Script Comment - Konfigurasi parameter script comment
• Konfigurasi Skrip Boost Comment (Balas) - Suka/balas komentar yang ada
• Konfigurasi Skrip Like - Konfigurasi parameter skrip like
• Konfigurasi Skrip View - Tonton postingan selama durasi yang dapat dikonfigurasi
• Konfigurasi Skrip Favorite - Simpan postingan ke Favorit
• Konfigurasi Skrip Pesan - Konfigurasi parameter skrip pesan
• Konfigurasi Script Login - Konfigurasi parameter script login
• Konfigurasi Script Profil - Konfigurasi parameter script profil
• Konfigurasi Script Pencocokan Akun - Konfigurasi parameter script pencocokan akun
• Konfigurasi Skrip Super Marketing - Impor kumpulan data target dan luncurkan kampanye super marketing
• Contoh API - Contoh kode dalam berbagai bahasa
• API Scan TCP - Memindai dan menghubungkan perangkat Android melalui TCP/IP
• API Status Akun - Menanyakan status akun, konektivitas perangkat, dan status login