Getting Started
Introduction
KIMYUZIN adalah platform OTP (One-Time Password) terpercaya yang menyediakan akses ke 50+ layanan digital melalui 2 server premium.
Satu API, 50+ Layanan
Akses semua layanan melalui satu endpoint. Auto-failover antar server untuk ketersediaan tinggi.
Getting Started
Quick Start
Dapatkan API Key dalam 1 menit dan buat order pertamamu.
Step 1: Dapatkan API Key
Kirim /api ke @kimyuzinbot di Telegram.
Step 2: Buat Order
curl -X POST https://kimyuzin.store/api/v1/order \
-H "Authorization: Bearer kz_live_xxx" \
-d '{"service": "shopee", "server": "auto"}'
Step 3: Terima OTP
{
"success": true,
"order_id": "KIM-20260901-XXXXX",
"server": "server1",
"phone": "62838XXXXXXX",
"status": "waiting"
}
Getting Started
Authentication
Semua request API wajib menyertakan API Key di header Authorization.
Authorization: Bearer kz_live_xxxxxxxxx
Jangan bagikan API Key Anda. Rotasi secara berkala untuk keamanan.
Getting Started
API Keys
Generate dan kelola API Key langsung dari bot Telegram.
Generate via Telegram
/api
Bot akan membalas dengan API Key baru Anda.
API Reference
Create Order
POST
/v1/order
SERVER 1 & 2
Buat order OTP baru untuk layanan tertentu.
Request Body
{
"api_key": "kim_xxxxx",
"service": "shopee",
"server": "auto"
}
Response
{
"success": true,
"order_id": "KIM-20260901-XXXXX",
"server": "server1",
"phone": "62838XXXXXXX",
"price": 1200,
"status": "waiting"
}
Parameter Server
auto — Otomatis pilih server terbaik (recommended)
server1 — Server 1 - Premium
server2 — Server 2 - Ultra
API Reference
Order Status
GET
/v1/status/{order_id}
Cek status order & dapatkan OTP jika sudah tersedia.
Response
{
"success": true,
"order_id": "KIM-20260901-XXXXX",
"status": "completed",
"otp": "123456",
"phone": "62838XXXXXXX"
}
API Reference
Resend OTP
POST
/v1/order/{order_id}/resend
SERVER 1 & 2
Minta ulang OTP untuk order yang masih aktif. Gratis dan tidak memotong saldo.
Syarat & Ketentuan
- Order harus dalam status
waiting atau processing
- Maksimal 5x resend per order
- Tidak ada potongan saldo tambahan
- Waktu berlaku otomatis diperpanjang +20 menit
Response
{
"success": true,
"order_id": "KIM-20260901-XXXXX",
"server": "server1",
"status": "waiting",
"resend_count": 1,
"expires_at": "2026-09-01T12:00:00"
}
API Reference
Balance
GET
/v1/balance
Cek saldo akun Anda.
{
"success": true,
"balance": 50000
}
API Reference
Services
GET
/v1/services
Daftar semua layanan OTP yang tersedia di KIMYUZIN.
{
"success": true,
"server1": [
"shopee", "gopay", "facebook", "..."
],
"server2": [
"dana", "ovo", "grab", "..."
]
}
Resources
Error Codes
400
Bad Request
Parameter yang dikirim tidak lengkap atau format salah. Cek request body Anda.
401
Unauthorized
API Key tidak valid atau sudah expired. Generate API Key baru lewat @kimyuzinbot.
402
Insufficient Balance
Saldo tidak cukup untuk melakukan order. Silakan isi saldo melalui deposit QRIS.
403
Forbidden
Anda tidak memiliki akses ke resource ini. Cek role atau izin akun Anda.
404
Not Found
Endpoint atau order_id tidak ditemukan. Cek kembali URL atau ID order Anda.
409
Order Conflict
Order sudah aktif untuk user ini. Maksimal 5 order aktif (Bot) atau 20 order aktif (API). Tunggu order selesai/kadaluarsa.
410
Order Expired
Order sudah kadaluarsa. Silakan buat order baru.
422
Unprocessable Entity
Service tidak tersedia di server yang dipilih. Coba gunakan server: "auto".
429
Rate Limit Exceeded
Terlalu banyak order aktif. Maksimal 5 order (Bot) atau 20 order (API) per user. Tunggu order selesai/kadaluarsa.
500
Internal Server Error
Terjadi kesalahan pada server kami. Tim sedang menangani. Coba lagi nanti.
503
Server Maintenance
Server yang dipilih sedang dalam maintenance.
Gunakan "server": "auto"
untuk failover otomatis ke server yang tersedia.
503
All Servers Down
Kedua server sedang offline. Kami sedang melakukan perbaikan.
Silakan coba lagi nanti. Pantau status di @kimyuzinbot.