JuraganAPI.DEVELOPER CENTERBuka dashboard ↗
DOKUMENTASI GAME API

Dari request pertama
ke integrasi Anda.

Panduan praktis untuk menghubungkan website Anda, memvalidasi pemain, dan memahami setiap respons API.

REST API Format JSON… Point Per hasil berhasil1 endpoint Banyak layanan game
01

Siapkan integrasi Anda

Ikuti urutan ini sebelum mengirim request pertama.

01

Daftarkan website

Buat akun, lalu tambahkan website yang akan memakai API.

Kelola website ↗
02

Buat API key

Pilih website, buat key, dan simpan secret yang hanya muncul sekali.

Buat API key ↗
03

Daftarkan IP server

Ajukan IP publik server pengirim request. Tunggu status APPROVED.

Atur whitelist IP ↗
04

Siapkan Point & coba API

Pastikan saldo cukup, lalu validasi satu akun dari backend Anda.

Buka API tester ↗
Mulai dengan data pemain yang Anda ketahui.

Gunakan User ID dan Zone / Server yang benar. Tester dashboard memakai Point untuk hasil berhasil, sama seperti penggunaan API.

02

API key & akses server

Satu key terikat pada website, akun, dan environment Anda.

Header autentikasi
Authorization: Bearer YOUR_API_KEY

Simpan key di backend

Gunakan environment variable seperti GAME_API_KEY. Jangan menaruh key di JavaScript browser atau aplikasi pelanggan.

Gunakan IP yang disetujui

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.

03

Kirim request validasi

Kirim JSON dari server Anda ke endpoint berikut.

POSThttps://api.hrdjuragan.site/api/v1/game/check

Header yang diperlukan

HeaderNilaiKeterangan
AuthorizationBearer YOUR_API_KEYKey aktif milik website Anda.
Content-Typeapplication/jsonBody request menggunakan JSON.
Idempotency-KeyUUID unikUUID baru per operasi. Pakai UUID yang sama saat retry operasi tersebut.

Body request

ParameterTipeCara mengisi
gamestring · wajibSlug layanan. Contoh: mobile-legends-indonesia.
user_idstring · wajibID pemain. Untuk Valorant, gunakan Riot ID lengkap beserta tag.
zone_idstring · sesuai gameZone 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.

04

Salin contoh integrasi

Contoh ini menggunakan MLBB Indonesia. Ganti key dan data pemain sebelum menjalankannya.

cURL · Request dari backend
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"}'
UUID pada contoh bukan untuk digunakan berulang kali.

Buat UUID baru untuk setiap pengecekan baru. Simpan UUID tersebut bila Anda perlu mengirim ulang request yang sama setelah gangguan koneksi.

05

Pahami hasilnya

Periksa HTTP status, success, dan error sebelum melanjutkan transaksi Anda.

Contoh response · HTTP 200
{
  "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.

06

Game & parameter

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.

07

Pilih region MLBB yang tepat

Kedua varian memakai User ID dan Zone ID.

INDONESIA

MLBB Indonesia

mobile-legends-indonesia

Hanya menerima akun dengan country Indonesia dari provider. Akun negara lain ditolak tanpa biaya.

GLOBAL

MLBB Global

mobile-legends-global

Menerima akun dari seluruh negara tanpa pembatasan country.

Contoh penolakan region · HTTP 422
{
  "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.

08

Biaya, batas request & retry

Ketahui kapan saldo berkurang dan kapan request boleh diulang.

… PointTarif standar per hasil berhasil
Rp1 = 1 PointTop up sesuai nominal kebutuhan
… / menitBatas default per API key

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.

Mengulang operasi yang sama

Pakai Idempotency-Key dan parameter yang sama. Hasil tersimpan dikembalikan tanpa biaya tambahan. Bila masih diproses (409), tunggu sebelum retry.

Memulai pengecekan baru

Buat UUID baru, termasuk jika ingin mengecek ulang hasil gagal atau mengganti game. Jika menerima 429, tunggu sesuai Retry-After.

Top up Point →
09

Temukan solusi error

Cari kode atau masalah yang muncul pada respons Anda.

401

INVALID_API_KEY

Periksa API key pada header Authorization.

403

API_KEY_REVOKED / API_KEY_SUSPENDED / API_KEY_EXPIRED

Gunakan key aktif; buat key baru bila perlu.

403

IP_NOT_WHITELISTED

Pastikan IP publik server berstatus APPROVED.

403

API_KEY_ENVIRONMENT_MISMATCH

Gunakan key untuk environment yang sedang aktif.

403

WEBSITE_INACTIVE / USER_SUSPENDED

Periksa status website atau hubungi admin.

402

INSUFFICIENT_POINT

Top up Point sebelum mencoba kembali.

409

REQUEST_IN_PROGRESS

Tunggu lalu kirim ulang dengan UUID dan parameter yang sama.

409

IDEMPOTENCY_CONFLICT

UUID sudah digunakan untuk parameter berbeda. Buat UUID baru untuk operasi baru.

422

INVALID_PARAMETER / IDEMPOTENCY_KEY_REQUIRED

Periksa game, User ID, Zone / Server, dan UUID request.

422

PLAYER_NOT_FOUND

Periksa kembali ID pemain. Request ini tidak ditagih.

422

MLBB_REGION_NOT_INDONESIA

Akun Kamu Bukan Region Indonesia. Gunakan MLBB Global bila menerima seluruh negara.

429

RATE_LIMITED

Tunggu sesuai header Retry-After sebelum mengirim ulang.

502

PROVIDER_COUNTRY_UNAVAILABLE

Region belum dapat diverifikasi. Request ini tidak ditagih.

502 / 504

PROVIDER_ERROR / PROVIDER_TIMEOUT

Provider sedang bermasalah. Periksa hasil request sebelum mencoba kembali.

503

GAME_OFFLINE / MAINTENANCE / PROVIDER_UNAVAILABLE

Layanan belum tersedia. Periksa katalog atau coba lagi nanti.

Siap terhubung?

Buka dashboard untuk mengelola key, saldo, dan request Anda.

Buka dashboard ↗