Lewati ke konten

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.

  1. 01

    Daftar akun

    Satu akun mendapat satu API key tetap.

  2. 02

    Top-up token

    Bayar QRIS; token masuk ke key yang sama.

  3. 03

    Daftarkan IP server

    Tambahkan IP publik server Anda di menu Developer.

  4. 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 …",
  "summaryStatus": "ok"
}

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

Ulang AI Summary (gratis)

Jika AI sedang sibuk, summary bernilai null dengan summaryStatus: "busy" dan retryAfterSec. Hasil cek tetap tersimpan — ambil ringkasannya nanti lewat endpoint ini tanpa memotong token.

curl https://cek-nomor.com/api/v1/check/6f1c…/summary -H "X-API-Key: gtc_…"
// 200 — berhasil
{ "ok": true, "checkId": "6f1c…", "summary": "Nomor 0812… berkaitan dengan …" }

// 503 — masih sibuk (header Retry-After ikut dikirim)
{ "ok": false, "error": { "code": "AI_BUSY", "message": "…" }, "checkId": "6f1c…", "retryAfterSec": 300 }
  • summaryStatus: ok, busy (ulang setelah retryAfterSec), no_data (data terlalu sedikit — tidak perlu diulang), atau disabled.
  • Tunggu sesuai retryAfterSec / header Retry-After; permintaan sebelum itu langsung dijawab 503 tanpa diproses.
  • Ringkasan yang sudah jadi disimpan — memanggil endpoint ini lagi selalu mengembalikan hasil yang sama.

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

401MISSING_API_KEY / INVALID_API_KEYHeader X-API-Key kosong atau salah.
403ACCOUNT_REQUIREDKey hasil beli tanpa akun tidak bisa memakai API.
403NO_WHITELIST / IP_NOT_ALLOWEDIP server belum/tidak terdaftar di whitelist.
402INSUFFICIENTSisa token habis.
429RATE_LIMITEDMelebihi batas per menit. Lihat header Retry-After.
503UPSTREAM_DOWNSemua sumber gangguan. Token dikembalikan otomatis.
503AI_BUSYAI Summary sibuk (endpoint ulang ringkasan). Ulangi setelah retryAfterSec — gratis.
404NOT_FOUNDcheckId tidak ada atau bukan milik key ini (endpoint ulang ringkasan).
422NO_DATAData sumber terlalu sedikit untuk diringkas — tidak perlu diulang.
{ "ok": false, "error": { "code": "IP_NOT_ALLOWED", "message": "IP 198.51.100.7 tidak ada di whitelist." } }