DYOGG/ Developers
App

Weapon

Metadata weapon / light cone / w-engine — base stats curve, refinement passive, sourceability.

Resource Weapon mencakup weapon (Genshin), light cone (HSR), dan w-engine (ZZZ) dalam schema seragam.

GET /v1/weapon/{game}/{weapon_id}

Path params

NamaTipeRequired
gameenum✓
weapon_idinteger✓

Query params

NamaTipeDefault
langstringen
include_curvebooleanfalse

Response 200

{
  "data": {
    "id": 15511,
    "game": "genshin",
    "name": "Bloodsoaked Ruins",
    "kind": "weapon",
    "type": "Sword",
    "rarity": 5,
    "base_atk_lv1": 46,
    "base_atk_lv90": 674,
    "secondary": { "stat": "CRIT Rate", "value_lv1": 0.096, "value_lv90": 0.221 },
    "refinements": [
      { "rank": 1, "description": "…" },
      { "rank": 2, "description": "…" }
    ],
    "sources": ["Weapon Banner: Whimsy of Weft"],
    "icon_url": "https://cdn.dyogg.com/genshin/weapons/Bloodsoaked_Ruins.png"
  }
}

GET /v1/weapons/{game}

Catalog weapon dalam game.

Query params

NamaTipeDefault
typestring— (Sword/Claymore/dst)
rarityinteger—
cursor, limit...—

Konvensi

  • kind = weapon (GI), light_cone (HSR), w_engine (ZZZ).
  • refinements selalu berisi 5 rank untuk GI/HSR, 5 phase untuk ZZZ.
  • sources = pool aja dapat diperoleh (banner, event shop, chest, dsb).