Docs · ReactionWA

POST /api/v1/react

Authentication

Sertakan header x-api-key berisi DEV key kamu.

Request Body

{
  "url": "https://whatsapp.com/channel/xxxxxxxx/123",
  "reaction": "🥳,👍",
  "requestId": "optional-idempotency-id"
}

Response (queued)

{
  "success": true,
  "code": "QUEUED",
  "message": "Request kamu sedang berada dalam antrean.",
  "requestId": "...",
  "status": "waiting",
  "queue": { "position": 2, "total": 3 }
}

Response (error)

{
  "success": false,
  "code": "RATE_LIMIT",
  "message": "Rate limit tercapai. Coba lagi sebentar lagi."
}

Error Codes

INVALID_URL — URL postingan tidak valid
INVALID_REACTION — Emoji tidak valid / lebih dari 3
UNAUTHORIZED — DEV key tidak dikirim
INVALID_KEY / EXPIRED_KEY — DEV key tidak valid
HOST_NOT_ALLOWED — Origin/host tidak diizinkan untuk key ini
RATE_LIMIT — Rate limit per menit tercapai
MAINTENANCE — Layanan sedang maintenance
SERVICE_BUSY / UPSTREAM_ERROR — Gagal di sisi layanan reaction

Rate Limit

Setiap DEV key memiliki rate limit per menit yang dapat diatur Owner melalui Admin Panel. Semua request, termasuk dari plan DEV, tetap diproses melalui antrean global satu-per-satu ke upstream.

Allowed Host

Owner dapat membatasi DEV key agar hanya bisa dipakai dari host/origin tertentu. Jika tidak diatur, key dapat digunakan dari mana saja — tetap rahasiakan key kamu, karena header Origin/Referer saja bukan lapisan keamanan yang sempurna.

Contoh cURL

curl -X POST "https://your-domain.com/api/v1/react" \
  -H "Content-Type: application/json" \
  -H "x-api-key: DEV-XXXXXXXXXXXX" \
  -d '{
    "url": "https://whatsapp.com/channel/xxxxxxxx/123",
    "reaction": "🥳,👍"
  }'

Contoh JavaScript

const res = await fetch("https://your-domain.com/api/v1/react", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "DEV-XXXXXXXXXXXX",
  },
  body: JSON.stringify({
    url: "https://whatsapp.com/channel/xxxxxxxx/123",
    reaction: "🥳,👍",
  }),
});
const data = await res.json();
console.log(data);

Contoh Python

import requests

resp = requests.post(
    "https://your-domain.com/api/v1/react",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "DEV-XXXXXXXXXXXX",
    },
    json={
        "url": "https://whatsapp.com/channel/xxxxxxxx/123",
        "reaction": "🥳,👍",
    },
)
print(resp.json())

Ketentuan Penggunaan API

Penggunaan API DEV tunduk pada Ketentuan & Syarat Penggunaan. Jangan membagikan DEV key kamu ke pihak lain, dan jangan gunakan API untuk tujuan yang melanggar ketentuan tersebut.

Reaction API