Nasky API - Kopi Kenangan Checker

🚀 Cara Pakai (5 langkah)

1️⃣ Buka bot Telegram

@otpviawacheckbot → kirim /start. Di menu 👤 Profile kamu dapat user_id, unique_code (#XXXXXXX), dan API Key.

2️⃣ Isi Saldo

Klik 💳 Isi Saldo → pilih nominal → scan QRIS. Tarif Rp 100/cek, dipotong hanya kalau nomornya FRESH.

3️⃣ Generate API Key

Klik 🔑 API Key → Generate. GRATIS. Hanya 1 key aktif per user — generate ulang otomatis menghapus yang lama.

4️⃣ Cek Nomor

Pakai form di bawah, atau kirim request ke POST /api/cek dengan header X-API-Key.

5️⃣ Lihat Saldo & Riwayat

Saldo tampil otomatis di form di bawah (realtime). Riwayat transaksi ada di menu 📜 History di bot.

🔐 Perlu auth apa?

Cek nomor & saldo: header X-API-Key.
Data user (profile, API key, riwayat): kirim user_id + unique_code bersamaan.

🔍 Cek Nomor Kopi Kenangan

Masukkan API key dan nomor HP untuk mengecek status pendaftaran

💸 Rp 100 per nomor FRESH — dipotong dari saldo. Nomor terdaftar gratis. Saldo & top-up di bot Telegram @otpviawacheckbot.

💰 Saldo realtime: — (tempel API key untuk lihat saldo)

Mengecek nomor...

Hasil

📋 Endpoint API

POST https://nasky.web.id/api/cek

Headers:

X-API-Key - API Key wajib

Body:

{
  "code": "kopken",
  "nomor": "081234567890"
}

Endpoint data user (info, API key, riwayat) butuh user_id + unique_code Anda:

GET /api/user/me?user_id=12345&unique_code=%23A7X9K2M

Tanda # harus ditulis %23 di URL (atau boleh dikosongkan).

✅ Response Sukses

{
  "success": true,
  "message": "Check completed",
  "data": {
    "phone": "6281234567890",
    "status": "fresh",
    "customer_name": null,
    "attempts": 1,
    "message": "Nomor FRESH! Belum terdaftar"
  },
  "check_id": "CHK-A1B2C3D4E5F6",
  "timestamp": "2026-10-07T00:30:00.000000",
  "charged": 100,
  "balance_after": 19900
}

status = fresh (belum terdaftar) atau registered (sudah terdaftar → customer_name berisi nama pelanggan).

❌ Response Error

// 401 - API Key salah
{
  "detail": "Invalid API key"
}

// 402 - Saldo tidak cukup (Rp 100/cek)
{
  "detail": "Saldo kurang. Butuh Rp 100, saldo kamu Rp 50. Top up lewat bot (Isi Saldo)."
}

// 403 - API Key kedaluwarsa
{
  "detail": "API key has expired"
}

// 422 - Nomor tidak valid (saldo TIDAK terpotong)
{
  "detail": "Format nomor tidak valid. Gunakan nomor HP Indonesia, contoh: 081234567890 / 6281234567890"
}

📂 Cek Massal (Bulk)

Cek sampai 2000 nomor sekaligus dalam satu request. Tarif Rp 100 hanya untuk nomor FRESH — terdaftar & tidak valid gratis. Kalau saldo tidak cukup, sisanya masuk unchecked_numbers (belum dicek).

POST /api/cek-bulk
Header: X-API-Key: nasky_xxx
Body:
{
  "code": "kopken",
  "nomor": ["081234567890", "6281234567891", "081234567892"]
}

// Response
{
  "success": true,
  "total": 3,
  "fresh": 1,
  "registered": 2,
  "invalid": 0,
  "unchecked": 0,
  "charged": 100,
  "price_per_fresh": 100,
  "balance_after": 19900,
  "fresh_numbers": ["6281234567890"],
  "registered_numbers": ["6281234567891", "6281234567892"],
  "invalid_numbers": [],
  "unchecked_numbers": [],
  "details": [
    {"phone": "6281234567890", "status": "fresh", "customer_name": null}
  ]
}

Di bot Telegram: tombol 📂 Cek Massal (TXT) — kirim file .txt (satu nomor per baris). Hasilnya dikirim sebagai 1 file hasil_cek.txt yang di dalamnya sudah dipisah per kategori: FRESH, TERDAFTAR, TIDAK VALID, dan BELUM DICEK (kalau saldo habis — tinggal top up lalu kirim ulang daftarnya).

⚡ Status Sistem

🛡️ Fitur Keamanan

✅ X-API-Key Authentication

Setiap request wajib menyertakan API key di header

✅ Idempotency Protection

Mencegah request duplikat dengan ID unik

✅ Redis Caching

Respons cepat dengan cache 5 menit

♾️ Tanpa Batas Harian

Cek berapa pun per hari bebas. Dipotong Rp 100 hanya kalau nomornya FRESH.

📚 Dokumentasi Lengkap

Silakan akses Swagger UI untuk dokumentasi interaktif:

📖 Swagger UI Docs

☕ Kopi Kenangan Checker API