Daftarkan website
Buat akun, lalu tambahkan website yang akan memakai API.
Kelola website ↗Panduan praktis untuk menghubungkan website Anda, memvalidasi pemain, dan memahami setiap respons API.
Ikuti urutan ini sebelum mengirim request pertama.
Buat akun, lalu tambahkan website yang akan memakai API.
Kelola website ↗Pilih website, buat key, dan simpan secret yang hanya muncul sekali.
Buat API key ↗Ajukan IP publik server pengirim request. Tunggu status APPROVED.
Atur whitelist IP ↗Pastikan saldo cukup, lalu validasi satu akun dari backend Anda.
Buka API tester ↗Gunakan User ID dan Zone / Server yang benar. Tester dashboard memakai Point untuk hasil berhasil, sama seperti penggunaan API.
Satu key terikat pada website, akun, dan environment Anda.
Authorization: Bearer YOUR_API_KEYGunakan environment variable seperti GAME_API_KEY. Jangan menaruh key di JavaScript browser atau aplikasi pelanggan.
Request harus datang dari IP publik server berstatus APPROVED. IP browser, Origin, atau Referer tidak menggantikan whitelist.
Saldo Sandbox dan Production terpisah. Jika environment berubah, gunakan key sesuai environment aktif. Key yang dicabut tidak dapat diaktifkan kembali.
Kirim JSON dari server Anda ke endpoint berikut.
https://api.hrdjuragan.site/api/v1/game/check| Header | Nilai | Keterangan |
|---|---|---|
| Authorization | Bearer YOUR_API_KEY | Key aktif milik website Anda. |
| Content-Type | application/json | Body request menggunakan JSON. |
| Idempotency-Key | UUID unik | UUID baru per operasi. Pakai UUID yang sama saat retry operasi tersebut. |
| Parameter | Tipe | Cara mengisi |
|---|---|---|
| game | string · wajib | Slug layanan. Contoh: mobile-legends-indonesia. |
| user_id | string · wajib | ID pemain. Untuk Valorant, gunakan Riot ID lengkap beserta tag. |
| zone_id | string · sesuai game | Zone atau server bila diminta. Lihat daftar parameter game di bawah. |
Kirim ID sebagai string agar nilainya tetap utuh. Anda tidak perlu mengirim nominal tarif atau jumlah Point.
Contoh ini menggunakan MLBB Indonesia. Ganti key dan data pemain sebelum menjalankannya.
curl --request POST 'https://api.hrdjuragan.site/api/v1/game/check' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: 01951664-7ca0-7421-9d20-6e1bf63d879a' \
--data '{"game":"mobile-legends-indonesia","user_id":"123456789","zone_id":"1234"}'Buat UUID baru untuk setiap pengecekan baru. Simpan UUID tersebut bila Anda perlu mengirim ulang request yang sama setelah gangguan koneksi.
Periksa HTTP status, success, dan error sebelum melanjutkan transaksi Anda.
{
"success": true,
"request_id": "UUID_REQUEST",
"data": {
"username": "Example Player",
"status": "valid",
"game": "mobile-legends-indonesia",
"user_id": "123456789",
"zone_id": "1234",
"country": "Indonesia"
},
"error": null,
"billing": {
"point_used": 5
},
"response_ms": 820
}data.usernameNickname pemain yang berhasil ditemukan.data.countryNegara akun bila tersedia dari provider.billing.point_usedPoint yang dipotong untuk request ini.request_idSimpan untuk mencari transaksi di Log API.Respons di atas adalah ilustrasi. Nilai sebenarnya mengikuti pemain, tarif game, dan hasil provider.
Pilih game untuk melihat slug dan kebutuhan datanya.
Memuat katalog…
Katalog publik juga tersedia melalui GET https://api.hrdjuragan.site/api/v1/games, tanpa API key.
Kedua varian memakai User ID dan Zone ID.
mobile-legends-indonesiaHanya menerima akun dengan country Indonesia dari provider. Akun negara lain ditolak tanpa biaya.
mobile-legends-globalMenerima akun dari seluruh negara tanpa pembatasan country.
{
"success": false,
"request_id": "UUID_REQUEST",
"data": null,
"error": {
"code": "MLBB_REGION_NOT_INDONESIA",
"message": "Akun Kamu Bukan Region Indonesia"
},
"billing": {
"point_used": 0
},
"response_ms": 820
}Country dari frontend tidak menentukan region akun. Jika provider tidak menyediakan country, varian Indonesia mengembalikan HTTP 502 PROVIDER_COUNTRY_UNAVAILABLE tanpa biaya. Slug lama mobile-legends tetap menjadi alias Global. Gunakan UUID baru saat mengganti varian.
Ketahui kapan saldo berkurang dan kapan request boleh diulang.
Tarif khusus game dan batas khusus key dapat berbeda. Saldo direservasi sebelum provider dipanggil, lalu ditagih setelah hasil valid. Jika gagal, reservasi dilepas. Proses terputus dipulihkan scheduler setelah 5 menit.
Pakai Idempotency-Key dan parameter yang sama. Hasil tersimpan dikembalikan tanpa biaya tambahan. Bila masih diproses (409), tunggu sebelum retry.
Buat UUID baru, termasuk jika ingin mengecek ulang hasil gagal atau mengganti game. Jika menerima 429, tunggu sesuai Retry-After.
Cari kode atau masalah yang muncul pada respons Anda.
INVALID_API_KEYPeriksa API key pada header Authorization.
API_KEY_REVOKED / API_KEY_SUSPENDED / API_KEY_EXPIREDGunakan key aktif; buat key baru bila perlu.
IP_NOT_WHITELISTEDPastikan IP publik server berstatus APPROVED.
API_KEY_ENVIRONMENT_MISMATCHGunakan key untuk environment yang sedang aktif.
WEBSITE_INACTIVE / USER_SUSPENDEDPeriksa status website atau hubungi admin.
INSUFFICIENT_POINTTop up Point sebelum mencoba kembali.
REQUEST_IN_PROGRESSTunggu lalu kirim ulang dengan UUID dan parameter yang sama.
IDEMPOTENCY_CONFLICTUUID sudah digunakan untuk parameter berbeda. Buat UUID baru untuk operasi baru.
INVALID_PARAMETER / IDEMPOTENCY_KEY_REQUIREDPeriksa game, User ID, Zone / Server, dan UUID request.
PLAYER_NOT_FOUNDPeriksa kembali ID pemain. Request ini tidak ditagih.
MLBB_REGION_NOT_INDONESIAAkun Kamu Bukan Region Indonesia. Gunakan MLBB Global bila menerima seluruh negara.
RATE_LIMITEDTunggu sesuai header Retry-After sebelum mengirim ulang.
PROVIDER_COUNTRY_UNAVAILABLERegion belum dapat diverifikasi. Request ini tidak ditagih.
PROVIDER_ERROR / PROVIDER_TIMEOUTProvider sedang bermasalah. Periksa hasil request sebelum mencoba kembali.
GAME_OFFLINE / MAINTENANCE / PROVIDER_UNAVAILABLELayanan belum tersedia. Periksa katalog atau coba lagi nanti.
Buka dashboard untuk mengelola key, saldo, dan request Anda.