Validasi nickname game
dalam satu API call

Overview

Base URL produksi:

Semua endpoint mengembalikan application/json. Body POST harus dalam JSON dengan header Content-Type: application/json.

Authentication

Setiap request ke endpoint /check wajib menyertakan API key via header X-API-Key. Bisa juga via Bearer token atau query ?api_key=....

Request key gratis di halaman request.

X-API-Key: EVOGAMESTORE_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Format key: EVOGAMESTORE_ + 32 karakter random. Plain key hanya ditampilkan sekali saat pembuatan — simpan dengan aman.

Rate Limiting

Setiap API key memiliki rate limit per menit (default: 60 req/menit). Informasi limit tersedia di response headers:

List supported games

Public endpoint untuk discovery game yang didukung. Tidak butuh API key.

curl https://gamecheck.evogamestore.com/api/v1/games

const res = await fetch('https://gamecheck.evogamestore.com/api/v1/games');
    const { data } = await res.json();
    console.log(data);

$res = file_get_contents('https://gamecheck.evogamestore.com/api/v1/games');
    $data = json_decode($res, true)['data'];

Check nickname

Endpoint utama untuk validasi User ID dan ambil nickname.

Request body

Code examples

curl -X POST https://gamecheck.evogamestore.com/api/v1/check \
      -H "Content-Type: application/json" \
      -H "X-API-Key: EVOGAMESTORE_xxx" \
      -d '{
        "game": "mobile-legends",
        "user_id": "61010735",
        "zone": "2105"
      }'

const res = await fetch('https://gamecheck.evogamestore.com/api/v1/check', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'X-API-Key': 'EVOGAMESTORE_xxx',
      },
      body: JSON.stringify({
        game: 'mobile-legends',
        user_id: '61010735',
        zone: '2105',
      }),
    });
    const result = await res.json();

$ch = curl_init('https://gamecheck.evogamestore.com/api/v1/check');
    curl_setopt_array($ch, [
        CURLOPT_POST       => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'X-API-Key: EVOGAMESTORE_xxx',
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'game'    => 'mobile-legends',
            'user_id' => '61010735',
            'zone'    => '2105',
        ]),
    ]);
    $result = json_decode(curl_exec($ch), true);

Response status

API selalu menyertakan field status dengan tiga nilai mungkin. HTTP status code mencerminkan status itu juga.

{
      "status": "success",
      "data": {
        "username": "M A V E R I C K",
        "region": null
      },
      "response_time_ms": 421
    }

{
      "status": "not_found",
      "message": "USER ID tidak ditemukan",
      "response_time_ms": 612
    }

{
      "status": "temporary_failure",
      "message": "Sumber data sedang gangguan.",
      "response_time_ms": 8203
    }

Error reference

Selain 3 status di atas, beberapa error lain bisa muncul saat request bermasalah.

Batch check

Validasi hingga 10 akun sekaligus dalam satu request. Berguna untuk integrasi toko yang perlu validasi banyak order.

Request body

{
  "checks": [
    { "game": "mobile-legends", "user_id": "61010735", "zone": "2105" },
    { "game": "free-fire", "user_id": "123456789" },
    { "game": "genshin-impact", "user_id": "800100200", "zone": "os_asia" }
  ]
}

Response

{
  "status": "success",
  "total": 3,
  "data": [
    { "index": 0, "status": "success", "data": { "username": "MAVERICK", "region": null }, "response_time_ms": 320 },
    { "index": 1, "status": "not_found", "message": "Username tidak ditemukan.", "response_time_ms": 450 },
    { "index": 2, "status": "success", "data": { "username": "Traveler", "region": "Asia" }, "response_time_ms": 280 }
  ]
}

Maksimum 10 items per batch. Setiap item dihitung sebagai 1 request untuk rate limiting.

Webhooks

Daftarkan webhook URL untuk menerima notifikasi otomatis. Maksimum 5 webhook per API key.

Events yang didukung

Endpoints

Register webhook

POST /api/v1/webhooks
{
  "url": "https://yoursite.com/webhook",
  "events": ["key.expiring", "check.failed"]
}

Response menyertakan secret untuk verifikasi HMAC signature di header X-Webhook-Signature.

Key Rotation

Rotate API key tanpa downtime. Key lama tetap valid selama 24 jam (grace period).

Response

{
  "status": "success",
  "message": "Key berhasil di-rotate. Key lama masih valid selama 24 jam.",
  "data": {
    "new_key": "EVOGAMESTORE_abc123...",
    "new_prefix": "EVOGAMESTORE_abc1",
    "old_key_valid_until": "2026-05-16T16:47:00+07:00",
    "grace_period_hours": 24
  }
}

Status & Health

Monitor ketersediaan API dan status per game.

Health check

Return status database, cache, dan jumlah game yang didukung. Tidak butuh API key.

Public status page

Lihat status real-time semua game di /status. Diupdate otomatis setiap 5 menit.

API docs (JSON)

Dokumentasi lengkap dalam format JSON untuk integrasi programmatic.