DYOGG/ Developers
App

Honkai Star Rail

Endpoint publik untuk data Honkai Star Rail — player showcase, character, light cone, relic, trace tree.

Semua endpoint di-scoped {game}=hsr. Data source: showcase pipeline internal DYOGG. Auto-fallback ke jalur alternatif (untuk CN server) untuk resiliency maksimal.

Endpoint

GET /v1/player/hsr/{uid}

Player overview + character showcase (max 8 karakter yang dipajang).

Path params

NamaTipeRequiredDeskripsi
uidstring✓UID HSR — 9-10 digit. Prefix 6 = CN, 7 = OS.

Query params

NamaTipeDefaultDeskripsi
include_detailbooleantrueInclude light cone + relic + trace tree.
providerstringautoprimary / fallback / auto — force provider tertentu.
langstringenen, id, zh-cn, zh-tw, ja.

Response 200

{
  "data": {
    "uid": "602891308",
    "game": "hsr",
    "nickname": "Lumine",
    "level": 70,
    "world_level": 6,
    "signature": "...",
    "profile_picture_url": "https://cdn.dyogg.com/hsr/pfps/Series/200106.png",
    "showcase": [
      {
        "avatar_id": 1308,
        "name": "Acheron",
        "element": { "id": "Thunder", "name": "Lightning" },
        "path": { "id": "Warlock", "name": "Nihility" },
        "level": 80,
        "eidolon": 2,
        "ascension": 6,
        "light_cone": { "id": 23028, "name": "Along the Passing Shore", "level": 80, "superimpose": 1 },
        "relics": [ /* ... */ ],
        "trace_tree": [ /* 4 main skills + stat boost nodes */ ]
      }
    ]
  },
  "meta": { "cache": "hit", "ttl_seconds": 51, "request_id": "req_...", "api_version": "v1" }
}

GET /v1/character/hsr/{avatar_id}

Character metadata — path, element, ascension curve, main-stat table, eidolon deskripsi.

GET /v1/light-cone/hsr/{light_cone_id}

Light cone metadata — path, base stats curve, superimpose passive description (S1–S5).

GET /v1/relic/hsr/set/{set_id}

Relic set — 2pc/4pc/planar bonus, main-affix per slot, sub-affix table.

GET /v1/trace/hsr/{avatar_id}

Full trace tree — 4 main skills + stat boost nodes with unlock condition + level curve.

GET /v1/leaderboard/hsr/{avatar_id}

Global leaderboard per karakter berdasarkan CRIT DMG combined stat. Cache 5 menit.

Perbedaan penting vs Genshin

  • Eidolon vs Constellation — HSR pakai istilah E1-E6, DYO API expose sebagai eidolon: number.
  • Light cone bukan weapon — response schema pakai kata light_cone, bukan weapon.
  • Path — HSR-only, tidak ada di Genshin. Enum: Destruction, Hunt, Erudition, Harmony, Nihility, Preservation, Abundance, Remembrance.
  • Trace tree — 4 baris (Basic / Skill / Ultimate / Talent) masing-masing 3-4 stat boost nodes.

Batasan

  • CN UID (prefix 6) auto-switch ke jalur fallback; kamu bisa override via provider=fallback.
  • Karakter baru release <24 jam mungkin belum tersedia metadata (name/description null); relic metadata tetap accurate karena datang dari game struct.