DYOGG/ Developers
App

Player

Overview akun player lintas game — nickname, level, showcase, TrustScore.

Resource Player mengekspos data publik pemain lintas 3 game (Genshin / HSR / ZZZ).

GET /v1/player/{game}/{uid}

Ambil overview player + showcase karakter.

Path params

NamaTipeRequiredDeskripsi
gameenum✓genshin, hsr, zzz.
uidstring✓UID pemain (9-10 digit).

Query params

NamaTipeDefaultDeskripsi
include_detailbooleantrueInclude build detail per karakter.
include_trustbooleantrueInclude TrustScore info.
langstringenLanguage code.

Response 200 — object Player — lihat OpenAPI spec.

Response 4xx

  • 400 invalid_uid — Format UID tidak valid.
  • 404 player_not_found — UID tidak ditemukan atau showcase disembunyikan.
  • 429 rate_limited — Rate limit exceeded.

GET /v1/players/batch?uids=…&game={game}

Batch lookup — sampai 20 UID sekali request. Berguna untuk leaderboard atau bulk analytics.

Query params

NamaTipeRequiredDeskripsi
uidsstring✓Comma-separated, max 20.
gameenum✓genshin, hsr, zzz.

Response 200

{
  "data": [
    { "uid": "816973814", "nickname": "QuanZ", "level": 60, /* ... */ },
    { "uid": "816973815", "error": { "code": "not_found", "message": "UID hidden" } }
  ],
  "meta": { "fetched": 2, "cached": 1, "failed": 0 }
}

Example

curl "https://api.dyogg.com/v1/player/genshin/816973814" \
  -H "Authorization: Bearer dyo_test_YOUR_KEY"