HW-Genie

Hero Wars Automation Toolkit.

View on GitHub

Unit API Reference

概要

所持しているヒーロー、タイタン、ペット、およびそれらの育成データ（ステータス、スキル、スキン等）を取得するメソッドです。

Endpoint

POST https://heroes-wb.nextersglobal.com/api/
Content-Type: application/json; charset=UTF-8

heroGetAll - 全ヒーロー情報取得

所持している全ヒーローのステータス、レベル、ランク、スキル、スキン、グリフ、アーティファクト等の詳細を取得します。

curl 実行例

# 認証ヘッダー (x-auth-*) はブラウザ DevTools の「Copy as cURL」で取得した curl に含まれる
curl -s 'https://heroes-wb.nextersglobal.com/api/' \
  -H 'accept: */*' \
  -H 'content-type: application/json; charset=UTF-8' \
  --data-raw '{"calls":[{"name":"heroGetAll","args":{},"context":{"actionTs":1},"ident":"heroes"}]}'

Response Structure

{
  "results": [{
    "ident": "heroes",
    "result": {
      "response": {
        "2": {
          "id": 2,
          "xp": 3625195,
          "level": 130,
          "color": 16,
          "power": 74216,
          "star": 6,
          "skills": {
            "426": 130,
            "427": 130
          },
          "skins": {
            "2": 21,
            "32": 19
          }
        }
      }
    }
  }]
}

titanGetAll - 全タイタン情報取得

所持している全タイタンのステータス、レベル、星ランク等の情報を取得します。

curl 実行例

# 認証ヘッダー (x-auth-*) はブラウザ DevTools の「Copy as cURL」で取得した curl に含まれる
curl -s 'https://heroes-wb.nextersglobal.com/api/' \
  -H 'accept: */*' \
  -H 'content-type: application/json; charset=UTF-8' \
  --data-raw '{"calls":[{"name":"titanGetAll","args":{},"context":{"actionTs":1},"ident":"titans"}]}'

Response Structure

{
  "results": [{
    "ident": "titans",
    "result": {
      "response": {
        "4000": {
          "id": 4000,
          "level": 130,
          "power": 215197,
          "star": 6
        }
      }
    }
  }]
}

pet_getAll - 全ペット情報取得

所持している全ペットのステータス、レベル、星ランク等の情報を取得します。

curl 実行例

# 認証ヘッダー (x-auth-*) はブラウザ DevTools の「Copy as cURL」で取得した curl に含まれる
curl -s 'https://heroes-wb.nextersglobal.com/api/' \
  -H 'accept: */*' \
  -H 'content-type: application/json; charset=UTF-8' \
  --data-raw '{"calls":[{"name":"pet_getAll","args":{},"context":{"actionTs":1},"ident":"pets"}]}'

Response Structure

{
  "results": [{
    "ident": "pets",
    "result": {
      "response": {
        "pets": [
          {
            "id": 6001,
            "level": 130,
            "power": 163935,
            "star": 6
          }
        ]
      }
    }
  }]
}

inventoryGet - インベントリ/所持品

所持している全アイテム（装備、ソウルストーン、ポーション、ルーン等）のリストを取得します。

curl 実行例

# 認証ヘッダー (x-auth-*) はブラウザ DevTools の「Copy as cURL」で取得した curl に含まれる
curl -s 'https://heroes-wb.nextersglobal.com/api/' \
  -H 'accept: */*' \
  -H 'content-type: application/json; charset=UTF-8' \
  --data-raw '{"calls":[{"name":"inventoryGet","args":{},"context":{"actionTs":1},"ident":"inventory"}]}'

Response Structure

{
  "results": [{
    "ident": "inventory",
    "result": {
      "response": {
        "consumable": { "24": 1247415 },
        "gear": { "4": 866 }
      }
    }
  }]
}

response の各キーがカテゴリ（consumable / gear / scroll / fragmentScroll / fragmentGear / fragmentHero / ascensionGear 等、実測で 14 種）、その値が {libId: 個数} のマップです。consumable の libId は消費アイテムを表し、 事前定義された名前・消費方法は core/consumables.py のレジストリを参照してください。

consumableUseLootBox - ルートボックス（Loot Box）消費

consumable（inventoryGet の response.consumable）のうち、ルートボックス 種別のアイテムをまとめて開封します。レジストリ登録済み libId の一括消費は hw-genie consumable run で行えます。

curl 実行例

# libId 215（Equipment Fragment Chest）を 48 個消費
curl -s 'https://heroes-wb.nextersglobal.com/api/' \
  -H 'accept: */*' \
  -H 'content-type: application/json; charset=UTF-8' \
  --data-raw '{"calls":[{"name":"consumableUseLootBox","args":{"libId":215,"amount":48},"context":{"actionTs":1750526},"ident":"body"}]}'

Response Structure

{
  "results": [{
    "ident": "body",
    "result": {
      "response": {
        "48": {
          "fragmentScroll": { "218": 5, "192": 10, "193": 15, "216": 5 },
          "fragmentGear": { "91": 10, "93": 10, "171": 5, "94": 5 }
        }
      }
    }
  }]
}

response のキーは消費した数量（例: "48"）で、その値のカテゴリ （fragmentScroll 等）ごとに {libId: 報酬量} として報酬が返ります。 hw-genie ではこのカテゴリごとの合計を ConsumableUseResult.rewards に集計します。

選択式報酬ボックス（Chest of X Titans / Titan of Your Choice / Artifact 系 Chest 等）は args に playerRewardChoiceIndex を追加して報酬を選択します （例: Titan チェストは 2、Titan of Your Choice は 0、Artifact チェストは 4）。hw-genie では ConsumableInfo.player_reward_choice_index で アイテムごとに固定し、消費時に自動で args へ含めます。

マトリョーシカ系アイテム（開封で同種・下位ボックスが再出現するもの）は args に recursive: True を追加するとサーバー側で再帰開封され、開封 リクエスト数・ラウンド数の削減が見込まれるが、定量比較は未実施 （例: {"libId":509,"amount":17,"recursive":true}）。 在庫発生時にラウンド数・リクエスト数を recursive あり/なしで比較する。 hw-genie では ConsumableInfo.recursive=True で自動付与します（ consumableUseLootBox 以外のメソッドには付与しません）。付与対象は本番確認済み 3 件（478/509/513：2026-10-07 の multi consumable 本番実行で recursive 付き消費 SUCCESS を確認）と、既知マトリョーシカ 4 件（149/469/492/497：SKILL に libId ではなく名前で記載された既知マトリョーシカ （Ancient Titan Artifact Chest=149 / Adventure Chest=469 / Cosmic Titans Battle Chest=492 / Cosmic Battle Chest=497）に該当する libId。サーバー側再帰の実測は 未実施。ユーザー要求により少なくとも マトリョーシカ系は True とするため保持。実測後に本番確認済みへ昇格）に限定します （他は実測待ちのため付与しません。同名のみでは不十分のため、508（492 と同名だが 自体の証拠なし）・493（513 と同名）は対象外。tests の8種行 （149/469/492/497＋Doll 系 176/185/187/190）はクライアント側ラウンドループの 既存定義であり、サーバー側 recursive 対象はそのうち SKILL 名記載に該当する 4 件のみ）。 在庫 0 の libId（215・169・47）でのプローブは NotEnough 返却のため、サーバー側 recursive 受容可否の検証としては判定不能（再現手順：在庫 0 確認後に use_consumable を method=consumableUseLootBox・amount=1・recursive=True で直接呼び出し。47 は playerRewardChoiceIndex=2 を併せて付与）。 将来 unmeasured 品で recursive 起因の ERROR が出た場合、該当 libId の recursive を False に戻して再実行する（failed 扱いで取り残されるだけでサイレント消費なし）。

他の consumable 種別（consumableUseStamina 等）はアイテムごとにメソッドが 異なるため、実測で判明したものだけ core/consumables.py のレジストリに 登録しています。未登録アイテムは consumable run --method <method> で 明示指定できます。

その他のメソッド

  • heroRating_getInfo: ヒーローの評価・ランキング情報。
  • titanSpirit_getAll: タイタンの精霊（トーテム）の状況。
  • titanArtifactGetChest: タイタンアーティファクト宝箱の状況。
  • pet_getChest: ペットの宝箱の状況。
  • artifactGetChestLevel: アーティファクト宝箱のレベル。
  • roleAscension_getAll: ロール昇格（アセンション）の状況。