DYOGG/ Developers
App

Genshin Impact

Endpoint publik untuk data Genshin Impact — player showcase, character, weapon, artifact, dan namecard.

Semua endpoint di-scoped {game}=genshin. Data source: showcase pipeline internal DYOGG, di-cache 60 detik di edge CDN kami.

Endpoint

GET /v1/player/genshin/{uid}

Overview player + character showcase (max 8 karakter yang dipajang).

Path params

NamaTipeRequiredDeskripsi
uidstring✓UID Genshin — 9-10 digit angka.

Query params

NamaTipeDefaultDeskripsi
include_detailbooleantrueInclude weapon/artifact/stats per karakter.
fieldsstring—Comma-separated sparse fieldset.
langstringenen, id, ja, zh-cn — bahasa nama karakter.

Response 200

{
  "data": {
    "uid": "816973814",
    "game": "genshin",
    "nickname": "QuanZ",
    "level": 60,
    "world_level": 8,
    "region": "os_asia",
    "signature": "Traveler among realms",
    "namecard_id": 210036,
    "profile_picture_url": "https://cdn.dyogg.com/genshin/pfps/UI_AvatarIcon_...png",
    "trust_score": { "score": 92, "tier": "trusted" },
    "showcase": [
      {
        "avatar_id": 10000098,
        "name": "Flins",
        "element": "Electro",
        "level": 90,
        "constellation": 2,
        "ascension": 6,
        "weapon": { "id": 15511, "name": "Bloodsoaked Ruins", "level": 90, "refinement": 1 },
        "artifacts": [ /* ... */ ]
      }
    ]
  },
  "meta": { "cache": "hit", "ttl_seconds": 47, "request_id": "req_...", "api_version": "v1" }
}

Response 404

{ "error": { "code": "player_not_found", "message": "UID 816973814 tidak ditemukan atau showcase disembunyikan." } }

Example

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

GET /v1/character/genshin/{avatar_id}

Metadata karakter (nama, element, weapon type, ascension curve, talent tree).

Path params

NamaTipeRequiredDeskripsi
avatar_idinteger✓Avatar ID (mis. 10000098 untuk Flins).

Response 200 — object Character — lihat OpenAPI spec.

GET /v1/weapon/genshin/{weapon_id}

Metadata weapon (base ATK curve, secondary stat, refinement text, sourceability).

GET /v1/artifact/genshin/set/{set_id}

Artifact set — 2pc/4pc bonus description, character recommendation, main-affix table.

GET /v1/namecard/genshin/{namecard_id}

Namecard preview URL (banner + icon) — hosted di R2 CDN kita.

Batasan

  • include_detail=true hanya bekerja untuk karakter yang di-showcase dengan Show Details aktif di in-game. Kalau off, response showcase[].detail = null.
  • Data upstream cache 60 detik di source + 60 detik di kami = maksimal 120 detik lag data.
  • Beberapa karakter baru (rilis <7 hari) mungkin belum ada metadata di kami — akan return name: null dan element: null; tetap valid, tinggal refetch nanti.