Hero Wars RPC API Index (Start Here)

このドキュメントは、Hero Wars API に関する情報の入り口です。 APIの全体像と、機能ごとの詳細ドキュメントへのリンクをまとめています。

Hero WarsのAPIは、「機能ごとに独立したメソッド (xxxGetAll や xxxGetInfo) を用意し、それらを1つのHTTPリクエストに配列として束ねて送信する」というRPC（リモートプロシージャコール）スタイルを採用しています。

1つのHTTPリクエスト（POST /api/）の中に、callsという配列で多数のRPCメソッド呼び出し（APIコール）を詰め込み、サーバーからプレイヤーの全データを一括で取得したり、必要なデータだけをピンポイントで取得したりすることができます。

今後の課題 (TODO)

Library ID (アイテムID) のマスタデータ取得: libGet 相当のデータ（アイテム名、ヒーロー名、スキル定義等）を自動取得し、ローカルに保存・参照する仕組みの構築。現状は ID のみの表示となっている箇所が多い。
各 API の詳細な Request Payload 仕様の追記: 現在は主要なもののみ。

詳細仕様は以下のファイルを参照してください:

プレイヤーの基礎データや設定を取得します。

userGetInfo: プレイヤーID、レベル、経験値、アバターなどの基本情報。
getTime: サーバー時刻の同期。
settingsGetAll: ゲーム設定（音量、通知設定など）。
tutorialGetInfo: チュートリアルの進行状況。
mechanicAvailability: 特定の機能（タイタン、ペットなど）がアンロックされているかどうかの確認。
registration: ギフトID (giftId) が含まれており、ギフト付きリンクを踏んだ際の処理や、セッション開始の登録を兼ねています。

所持アイテムや通貨、購入可能な商品に関連する機能です。

inventoryGet: 所持している全アイテム（装備、ポーション、ルーンなど）のリスト。response.consumable が {libId: 個数}（詳細は UNIT_API.md）。
consumableUseLootBox: ルートボックス（consumable）の一括消費（args: {"libId": 215, "amount": 48}。レスポンスは response.<消費数>.fragmentScroll 等。詳細は UNIT_API.md）。
billingGetAll / billingGetLast: 課金通貨（エメラルド等）や購入履歴の状態。
shopGetAll: タウンショップ、アリーナショップ、ギルドショップなど、全ショップのラインナップと更新状況。
heroesMerchantGet: ヒーローのソウルストーンショップの状態（推測）。
specialOffer_getAll: 期間限定の課金オファー（x4セールなど）。

育成キャラクターたちのステータス情報です。

デイリー活動や報酬に関連する機能です。

ギルド活動やチャット機能です。

clanGetInfo: 所属ギルドの情報、メンバーリスト。
clanWarGetBriefInfo: ギルド戦（ゴールドリーグ等）の概要・対戦相手。
clanRaid_getInfo / clanDomination_getInfo: ギルドレイド（Asgard）の進捗（response.shop にショップ在庫・coins に残高。詳細は GUILD_API.md）。
clanRaid_shopBuy: ギルドレイド（Asgard）のショップ購入（args: {"slotId": N}。詳細は GUILD_API.md）。
chatGetAll: チャット履歴取得（chatType指定）。
chatServerSubscribe: リアルタイムチャット購読。
userGetAvailableStickers: 利用可能なスタンプ一覧。
friendsGetInfo: フレンドリストとギフト交換状況。

各コンテンツの攻略状況です。