API Developer

Satu request, semua sumber.

Integrasikan cek GetContact, WhatsApp, e-wallet, dan AI Summary ke sistem Anda. Hanya untuk akun terdaftar dengan whitelist IP.

Daftar & dapatkan API key Sudah punya akun

01
Daftar akun
Satu akun mendapat satu API key tetap.
02
Top-up token
Bayar QRIS; token masuk ke key yang sama.
03
Daftarkan IP server
Tambahkan IP publik server Anda di menu Developer.
04
Panggil API
Kirim X-API-Key dari server Anda.

Cek nomor

POST /api/v1/check — 1 token per request. Isi summary: true untuk sekaligus menunggu AI Summary (respons lebih lama).

curl -X POST https://cek-nomor.com/api/v1/check \
  -H "X-API-Key: gtc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"phone": "081234567890", "summary": true}'

{
  "ok": true,
  "checkId": "6f1c…",
  "remainingTokens": 41,
  "data": {
    "phone": "+6281234567890",
    "getcontact": { "status": "found", "displayName": "…", "tagCount": 12, "tags": [{ "tag": "…", "count": 4 }] },
    "whatsapp":   { "status": "found", "name": "…" },
    "ewallet":    { "dana": { "status": "found", "name": "…" }, "gopay": { "status": "not_found" }, … },
    "callerIds":  [{ "source": "truecaller", "label": "Truecaller", "name": "…" }]
  },
  "summary": "Nomor 0812… berkaitan dengan …"
}

status bernilai found, not_found, atau error (sumber gangguan).

Sisa token

curl https://cek-nomor.com/api/v1/balance -H "X-API-Key: gtc_…"

Status layanan

GET /api/status (publik, tanpa API key) — status & uptime tiap sumber. Tampilan lengkap di /status.

{ "ok": true, "overall": "OK", "services": [{ "key": "whatsapp", "name": "WhatsApp", "state": "OK", "uptime": { "d1": 99.8, "d7": 99.5, "d30": 99.6 } }, …] }

Keamanan & batasan

Hanya API key milik akun terdaftar, dan hanya dari IP yang ada di whitelist.
Kirim key lewat header X-API-Key dari server Anda — jangan taruh di aplikasi frontend atau mobile.
Batas 60 request per menit per key.
Jika key bocor, ganti dari menu Akun. Key lama langsung tidak berlaku.

Kode error

401	MISSING_API_KEY / INVALID_API_KEY	Header X-API-Key kosong atau salah.
403	ACCOUNT_REQUIRED	Key hasil beli tanpa akun tidak bisa memakai API.
403	NO_WHITELIST / IP_NOT_ALLOWED	IP server belum/tidak terdaftar di whitelist.
402	INSUFFICIENT	Sisa token habis.
429	RATE_LIMITED	Melebihi batas per menit. Lihat header Retry-After.
503	UPSTREAM_DOWN	Semua sumber gangguan. Token dikembalikan otomatis.

{ "ok": false, "error": { "code": "IP_NOT_ALLOWED", "message": "IP 198.51.100.7 tidak ada di whitelist." } }