Character

Metadata karakter (avatar/agent) lintas game — nama, element, path/specialty, ascension curve, deskripsi, art assets.

GET /v1/character/{game}/{avatar_id}

Detail karakter dari database kami.

Path params

NamaTipeRequiredDeskripsi
gameenumgenshin, hsr, zzz.
avatar_idintegerAvatar ID (numeric).

Query params

NamaTipeDefaultDeskripsi
langstringenBahasa deskripsi (en, id, ja, zh-cn, zh-tw).
include_talentsbooleantrueInclude talent/skill tree info.
include_ascensionbooleanfalseInclude material cost per ascension (heavy).

Response 200

{
  "data": {
    "id": 10000098,
    "game": "genshin",
    "name": "Flins",
    "rarity": 5,
    "element": "Electro",
    "weapon_type": "Sword",
    "region": "Snezhnaya",
    "release_version": "6.2",
    "portrait_url": "https://cdn.dyogg.com/genshin/portraits/Flins.png",
    "splash_url": "https://cdn.dyogg.com/genshin/splashes/Flins.png",
    "talents": [
      {
        "type": "normal",
        "name": "Northland Spearstorm",
        "description": "…",
        "params": [ /* per level scaling */ ]
      }
    ]
  }
}

GET /v1/characters/{game}

Full catalog karakter dalam game — 1-shot listing (dipakai untuk builder karakter, tier list, dsb).

Query params

NamaTipeDefaultDeskripsi
elementstringFilter by element (mis. Electro).
rarityinteger4 atau 5 (Genshin/HSR). S/A/B (ZZZ).
released_afterstringISO date, mis. 2025-01-01.
cursor, limit...Pagination.

Example

curl "https://api.dyogg.com/v1/character/hsr/1308?lang=id" \
  -H "Authorization: Bearer dyo_test_YOUR_KEY"