API Documentation

Dokumentasi resmi ZX REACTCH Reaction API. Semua endpoint bersifat publik, berbasis JSON, dan tidak memerlukan autentikasi.

Base URLhttps://your-domain.vercel.appAPI v6

01 Pengenalan

ZX REACTCH API memungkinkan kamu mengirim reaction ke post WhatsApp Channel secara terprogram. Satu request = satu pengiriman lengkap — sistem kami memprosesnya melalui antrean pengiriman yang aman. Kamu tidak perlu mengelola akun, token, atau login apa pun.

🔐

Tanpa autentikasi. Semua endpoint publik dan tidak memerlukan API key. Cukup kirim request JSON ke Base URL di atas.

⏳

Waktu proses. Satu request ke /api/react diproses selama 5–20 detik tergantung antrean. Set timeout client minimal 60 detik agar tidak terputus duluan.

🛡️

Anti-spam. Endpoint /api/react diproteksi rate limit per IP (lihat bagian Rate Limits). Pelanggaran dijawab 429 dengan field retryAfter — kirim ulang hanya setelah waktu tunggu habis.

Semua response mengandung field v (versi API, saat ini 6) — gunakan untuk memastikan dokumentasi yang kamu baca sesuai dengan response yang kamu terima.

02 Kirim Reaction

POST/api/react

Mengirim satu set reaction ke satu post WhatsApp Channel. Satu request = satu pengiriman — tidak ada parameter jumlah; kalau butuh beberapa pengiriman, panggil endpoint ini berkali-kali dengan menghormati rate limit. Hasil setiap request otomatis tercatat di statistik global.

Request Body

Field	Tipe	Wajib	Deskripsi
`url`	`string`	Wajib	URL lengkap post WhatsApp Channel. Format: `https://whatsapp.com/channel/[id-channel]/[id-post]` Catatan: alias `waUrl` juga diterima.
`reactions`	`string[]`	Opsional	Array emoji yang dikirim (disarankan 1–10 item). Contoh: `["😂", "👍", "❤️"]` Catatan: alias `rawEmojis` (string dipisah koma, mis. `"😂,👍"`) juga diterima. Jika dikosongkan, emoji default 😂 yang dikirim.

Contoh Request

cURL

curl -X POST https://your-domain.vercel.app/api/react \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://whatsapp.com/channel/0029VbDLqe7EquiSF4STU13o/451",
    "reactions": ["😂", "👍", "❤️"]
  }'

JavaScript (fetch)

const res = await fetch('https://your-domain.vercel.app/api/react', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    url: 'https://whatsapp.com/channel/0029VbDLqe7EquiSF4STU13o/451',
    reactions: ['😂', '👍', '❤️'],
  }),
  signal: AbortSignal.timeout(60000), // 1 request bisa 5-20 detik
});

const data = await res.json();
// { success: true, message: 'Reaction berhasil dikirim', ... }

Python (requests)

import requests

res = requests.post('https://your-domain.vercel.app/api/react', json={
    'url': 'https://whatsapp.com/channel/0029VbDLqe7EquiSF4STU13o/451',
    'reactions': ['😂', '👍', '❤️'],
}, timeout=60)

print(res.json())

Response Sukses — 200 OK

Response

{
  "v": 6,
  "success": true,
  "message": "Reaction berhasil dikirim",
  "logged": true,
  "loggedFailed": []
}

Field	Tipe	Deskripsi
`v`	`number`	Versi API (saat ini `6`)
`success`	`boolean`	`true` = reaction berhasil dikirim
`message`	`string`	Pesan status yang aman ditampilkan ke end-user
`logged`	`boolean`	Apakah request berhasil dicatat ke statistik global
`loggedFailed`	`string[]`	Daftar counter statistik yang gagal dicatat (kosong jika semua sukses)
`retryAfter`	`number?`	Hanya muncul saat `429`: durasi tunggu (detik) sebelum request berikutnya diizinkan

Response Rate Limited — 429 Too Many Requests

Response

{
  "v": 6,
  "success": false,
  "message": "Terlalu cepat — tunggu 7 detik lagi",
  "retryAfter": 7
}

🛡️

Tunggu selama retryAfter detik sebelum mengirim request berikutnya. Melakukan retry lebih cepat hanya akan memperpanjang pembatasan.

Response Gagal — 500

Response

{
  "v": 6,
  "success": false,
  "message": "Timeout — server sedang sibuk, coba lagi",
  "logged": true,
  "loggedFailed": []
}

ℹ️

Pesan error sengaja dibuat generik dan aman dipublikasikan (contoh: "Timeout — server sedang sibuk, coba lagi"). Detail teknis penyebab kegagalan tidak diekspos ke client. Aman untuk di-retry setelah beberapa detik.

03 Statistik Global & Live Log

GET/api/live

Mengambil statistik global (total request, sukses, gagal, jumlah emoji terkirim, statistik hari ini) beserta daftar aktivitas terbaru secara real-time.

Query Parameters

Parameter	Tipe	Wajib	Deskripsi
`limit`	`number`	Opsional	Jumlah entry live log yang dikembalikan. Default `40`, maksimal `200`.

cURL

curl 'https://your-domain.vercel.app/api/live?limit=10'

Response — 200 OK

Response

{
  "success": true,
  "v": 6,
  "stats": {
    "total": 128,
    "success": 125,
    "failed": 3,
    "reactions": 384,
    "lastTs": 1787847447337,
    "today": {
      "date": "2026-08-27",
      "total": 42,
      "success": 41,
      "failed": 1,
      "reactions": 126
    }
  },
  "logs": [
    {
      "id": "mtp2zk1a2b",
      "ts": 1787847447337,
      "type": "success",
      "message": "Reaction 😂👍❤️ terkirim",
      "reactions": ["😂", "👍", "❤️"],
      "url": "https://whatsapp.com/channel/…/451",
      "username": null
    }
  ]
}

Field	Tipe	Deskripsi
`stats.total`	`number`	Total seluruh request sepanjang waktu
`stats.success`	`number`	Total request sukses
`stats.failed`	`number`	Total request gagal
`stats.reactions`	`number`	Total emoji terkirim sepanjang waktu
`stats.lastTs`	`number \| null`	Timestamp (ms) aktivitas terakhir
`stats.today`	`object`	Statistik hari ini (reset tiap ganti hari, zona WIB)
`logs`	`array`	Entry aktivitas terbaru (terbaru duluan). `type` bisa `success`, `error`, atau `info`.

04 Top Post

GET/api/leaderboard

Mengambil daftar post WhatsApp Channel yang paling banyak mendapat reaction berdasarkan statistik sistem. Endpoint ini murni membaca data — tidak mengubah apa pun.

Query Parameters

Parameter	Tipe	Wajib	Deskripsi
`limit`	`number`	Opsional	Jumlah entri maksimal. Default `50`, maksimal `200`.

cURL

curl 'https://your-domain.vercel.app/api/leaderboard?limit=50'

Response — 200 OK

Response

{
  "success": true,
  "posts": [
    {
      "url": "https://whatsapp.com/channel/0029VbDLqe7EquiSF4STU13o/451",
      "count": 37
    },
    {
      "url": "https://whatsapp.com/channel/0029VbCNrb4DzgT7EgLB0f29/492",
      "count": 12
    }
  ]
}

Field	Tipe	Deskripsi
`posts[].url`	`string`	URL post WhatsApp Channel
`posts[].count`	`number`	Total reaction sukses yang pernah dikirim ke post tersebut

05 Kode Error

Status	Pesan	Penyebab
`400`	Parameter "url" wajib diisi	Request body tidak memuat field `url`
`405`	Method not allowed	HTTP method tidak sesuai (mis. GET ke `/api/react`)
`429`	Terlalu cepat — tunggu X detik lagi / Terlalu banyak request — tunggu ±X menit lagi / Limit harian tercapai — coba lagi dalam ±X jam	Rate limit per IP terlampaui. Response menyertakan `retryAfter` (detik) — tunggu selama itu sebelum retry.
`500`	Bervariasi (pesan generik)	Reaction gagal diproses — timeout, antrean penuh, limit pengiriman tercapai, atau gangguan jaringan. Aman untuk di-retry setelah beberapa detik.

06 Rate Limits & Best Practices

Endpoint /api/react diproteksi rate limit 3 lapis per IP. Semua limit dihitung per alamat IP pengunjung dan direset otomatis.

Proteksi	Limit (per IP)	Pesan saat terlampaui
Cooldown antar request	10 detik	Terlalu cepat — tunggu X detik lagi
Burst	Maks 8 request / 5 menit	Terlalu banyak request — tunggu ±X menit lagi
Harian	Maks 100 request / 24 jam	Limit harian tercapai — coba lagi dalam ±X jam

Best Practices

Praktik	Rekomendasi
Timeout client	Minimal 60 detik — 1 request diproses 5–20 detik
Jeda antar request	Minimal 10 detik (sama dengan cooldown rate limit)
Pola pemanggilan	Sekuensial (satu per satu) — hindari paralel dari client yang sama
Emoji per request	1–10 emoji per request
Retry saat gagal	Tunggu minimal 5 detik; saat `429`, tunggu sesuai `retryAfter`
Polling /api/live	Maksimal 1 kali per 5 detik per client

07 Changelog

Rate limit 3 lapis per IP (cooldown 10 detik, maks 8 request / 5 menit, maks 100 / hari) — pelanggaran dijawab 429 dengan field retryAfter. Endpoint /api/react kini 1 request per pengiriman (tanpa pengiriman massal per request).

Mesin pengiriman baru — lebih stabil dan tahan blokir. Response /api/react dirampingkan (field limit dan account dihapus), menerima alias waUrl / rawEmojis, dan leaderboard berubah menjadi daftar post paling banyak bereaksi (Top Post).

Response /api/react dibersihkan — hanya mengembalikan data milik pengguna. Ditambahkan field versi v, statistik global & harian pada /api/live.

Live log real-time dan statistik global. Setiap request otomatis tercatat beserta detail reaction-nya.

Delay antar request otomatis dengan variasi acak (anti-blokir) dan riwayat session tersimpan di sisi client.

Rilis awal — endpoint reaksi dasar dan leaderboard.

👑

Butuh bantuan atau mau update terbaru? Kunjungi saluran resmi ZX — Credit by ZX.