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, jadi Rp 10.000 = 100x cek.

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

💸 Tarif: Rp 100 / pengecekan — dipotong otomatis (realtime) dari saldo akun Anda. 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": "Insufficient balance. Need Rp 100, have Rp 50. Top up via 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"
}

⚡ 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. Batasnya hanya saldo (Rp 100/cek).

📚 Dokumentasi Lengkap

Silakan akses Swagger UI untuk dokumentasi interaktif:

📖 Swagger UI Docs

☕ Kopi Kenangan Checker API