API Cek Nomor Kopken

Cek nomor Kopken terdaftar atau fresh dari script, bot, atau aplikasi kamu sendiri.

Mulai

Tiap akun punya API key sendiri. Akun = akun Telegram kamu. Tiap nomor yang dicek lewat API motong kredit akun itu sendiri, kredit yang sama kayak di bot.

Buka web cek nomor, masuk pake kode dari bot Telegram (kirim /login).
Di kartu API, pencet Bikin API key. Simpen key-nya, cuma muncul sekali.
Isi kredit lewat bot: /topup (Rp100 per kredit).
Panggil API pake key itu.

Base URL: {{BASE}}

Autentikasi

Kirim API key di header, pilih salah satu:

x-api-key: kc_xxxxxxxx
Authorization: Bearer kc_xxxxxxxx

Jaga key kamu. Siapa pun yang pegang key bisa ngabisin kredit kamu. Jangan taruh di kode frontend atau aplikasi yang bisa dibongkar orang, jangan dibagi. Kebocoran? Pencet Ganti key di web, key lama langsung mati.

Kredit

1 kredit per nomor fresh (belum terdaftar di Kopken).
Nomor terdaftar, lain, dan error gratis.
Saldo 0 = request ditolak 402. Kredit abis di tengah batch = nomor sisanya skipped, ga dipotong.
Harga Rp100 per kredit. Top up lewat bot: /topup, bayar QRIS, kredit masuk otomatis.

Endpoint

GET/api/v1/me

Saldo kredit + jumlah nomor yang udah kamu cek.

{
  "ok": true,
  "id": 123456789,
  "credits": 250,
  "checked": 1200,
  "price": 100
}

GET/api/v1/check/{nomor}

Cek 1 nomor. Paling gampang buat dipanggil berkali-kali (boleh barengan sampe 10 per akun).

GET /api/v1/check/081234567890

{
  "ok": true,
  "phone": "081234567890",
  "status": "fresh",
  "credits": 249
}

POST/api/v1/check

Cek banyak nomor sekali jalan, maks 100 per request. phones boleh array, boleh juga teks (dipisah enter, koma, atau spasi). Nomor dobel otomatis dibuang.

Body

{ "phones": ["081234567890", "6285700000000", "+6281311112222"] }

Respon

{
  "ok": true,
  "results": [
    { "phone": "081234567890", "status": "fresh" },
    { "phone": "085700000000", "status": "registered" },
    { "phone": "081311112222", "status": "error" }
  ],
  "summary": { "registered": 1, "fresh": 1, "other": 0, "error": 1, "charged": 1 },
  "credits": 249
}

Field tambahan kalau ada: "stopped": true (kredit abis di tengah, sisanya skipped) dan "invalid": [...] (teks yang bukan nomor).

Isi tiap hasil

Field	Arti
`phone`	Nomor, selalu format `08…`
`status`	Hasil cek, liat Status. Yang `fresh` motong 1 kredit

Format nomor yang diterima: 08…, 628…, +628…, atau 8…. Spasi dan strip boleh.

Status nomor

Status	Arti	Kredit
fresh	Belum terdaftar di Kopken	−1
registered	Udah terdaftar	gratis
other	Ga bisa dipastiin terdaftar atau fresh	gratis
error	Gagal ngecek. Coba lagi	gratis
skipped	Ga dicek karena kredit abis di tengah batch	gratis

Error

Kalau gagal, respon pake kode HTTP di bawah dan body {"ok": false, "error": "pesan"}.

Kode	Kapan
`400`	Body salah, ga ada nomor valid, atau format nomor salah
`401`	API key ga dikirim atau salah
`402`	Kredit habis, top up dulu di bot
`409`	Masih ada cek banyak kamu yang jalan (API atau bot). Tunggu kelar
`413`	Lebih dari 100 nomor dalam 1 request
`429`	Kebanyakan cek barengan (maks 10 per akun)
`5xx`	Gagal ngecek atau server lagi gangguan, coba lagi bentar (kredit ga kepotong)

Batas

POST /api/v1/check: maks 100 nomor per request, 1 request jalan per akun (termasuk cek lewat bot). Daftar panjang? Potong per 100, kirim gantian.
GET /api/v1/check/{nomor}: maks 10 barengan per akun.
1 request 100 nomor bisa makan sampe ~1 menit. Set timeout client minimal 120 detik.

Contoh

# saldo
curl -H "x-api-key: KEY_KAMU" {{BASE}}/api/v1/me

# cek 1 nomor
curl -H "x-api-key: KEY_KAMU" {{BASE}}/api/v1/check/081234567890

# cek banyak (maks 100)
curl -X POST {{BASE}}/api/v1/check \
  -H "x-api-key: KEY_KAMU" -H "content-type: application/json" \
  -d '{"phones":["081234567890","085700000000"]}'

import requests

BASE = "{{BASE}}"
KEY = "KEY_KAMU"  # API key kamu
H = {"x-api-key": KEY}

def cek(nomor):
    """Cek sampe 100 nomor sekali jalan."""
    r = requests.post(f"{BASE}/api/v1/check", json={"phones": nomor}, headers=H, timeout=120)
    data = r.json()
    if r.status_code != 200:
        raise RuntimeError(f"{r.status_code}: {data.get('error')}")
    return data

def cek_semua(daftar):
    """Daftar panjang: dipotong per 100, berhenti kalau kredit abis."""
    for i in range(0, len(daftar), 100):
        data = cek(daftar[i:i + 100])
        yield from data["results"]
        if data.get("stopped"):
            break

for x in cek_semua(["081234567890", "085700000000"]):
    print(x["phone"], x["status"])

// Node 18+ (fetch bawaan). Jangan taruh key di kode frontend publik.
const BASE = '{{BASE}}';
const KEY = 'KEY_KAMU';

async function cek(phones) {
  const res = await fetch(`${BASE}/api/v1/check`, {
    method: 'POST',
    headers: { 'x-api-key': KEY, 'content-type': 'application/json' },
    body: JSON.stringify({ phones })
  });
  const data = await res.json();
  if (!res.ok) throw new Error(`${res.status}: ${data.error}`);
  return data;
}

const data = await cek(['081234567890', '085700000000']);
for (const r of data.results) console.log(r.phone, r.status);
console.log('sisa kredit:', data.credits);