『アークナイツ：エンドフィールド』のガチャ履歴を取得する

·(編集済み)· / , ·

681

閲覧·

いいね手作り

この記事を読む前に、コンテキストをより理解するために以下の記事を先に読むことをお勧めします。

Astrionyx - 鳴潮ガチャ分析ツールとその詳細

AI翻訳中文日本語

主要な洞察

AI · GEN

本日、『アークナイツ：エンドフィールド』が正式にサービス開始となった。少し時間を取ってプレイしてみた後、自分のガチャ分析アプリにガチャデータを取り込もうと考えた。

しかし、サービス開始直後ということもあり、ガチャデータをエクスポートできるツールが見当たらず、最終的には自分でこの機能を実装することにした。

以下では、その実装に至るまでの基本的な考え方をまとめている。同様の機能を実装したい方の参考になれば幸いだ。

URLに含まれる情報

まず、他のゲームと同様に、パケットキャプチャツールを用いることで、以下のようなガチャ履歴のAPIリンクを取得できる：

TEXT

https://ef-webview.hypergryph.com/api/record/char?lang=zh-cn&seq_id={seqId}&pool_type={poolType}&token={token}&server_id={serverId}

キャラクタープール

キャラクタープールでは、主に pool_type と seq_id の2つのパラメータに注目する。

pool_type はガチャプールの列挙値であり、現時点では以下のいずれかを取る：

出発スカウト（初心者プール）：E_CharacterGachaPoolType_Beginner
通常スカウト（恒常プール）：E_CharacterGachaPoolType_Standard
限定スカウト（期間限定プール）：E_CharacterGachaPoolType_Special

また、『原神』や『鳴潮』などとは異なり、エンドフィールドのガチャ履歴リンクには通常 seq_id パラメータが付与されている。

CodeBlock Loading...

これら2つの異なるプールのデータを観察すると、seq_id パラメータには以下のような特徴があることが分かる：

seq_id (seqId) はアカウント単位で管理される増加シーケンスであり、サブプールをまたいで共有される。ただし、キャラクタープールと武器プールではそれぞれ独立したシーケンスを持つ。同一タイプ内（すべてのキャラクタープール、またはすべての武器プール）では、サブプールを切り替えてもカウントはリセットされない。
数値が大きいほど、より新しい記録である。
リクエストに seq_id を含めない場合、そのプールにおける最新5件の記録（最大の seqId）が返される。

これらの特性から、ゲーム内のガチャ履歴画面で「新しい順から古い順へページ送りする操作」は、seq_id を徐々に減少させていく処理に対応していることが分かる。

また、レスポンスには hasMore フラグが含まれており、これは現在取得している最小 seqId よりも古いデータが存在するか、すなわち次ページが存在するかを示している。

武器プール

武器プールのAPIはキャラクタープールとは異なり、2段階でデータを取得する必要がある。

武器プール一覧の取得

まず、以下のAPIでユーザーがガチャ履歴を持つ武器プール一覧を取得する：

CodeBlock Loading...

武器プールは大きく以下の2種類に分類される：

限定武器プール：poolId が weponbox_*
恒常武器プール：poolId が weaponbox_constant_*

余談だが、限定武器プールの poolId に含まれる wepon はスペルミスと思われる。

武器ガチャ履歴の取得

各武器プールの履歴は、以下のAPIで取得する：

CodeBlock Loading...

武器データのフィールドはキャラクターと若干異なり、以下が追加されている：

weaponId：武器ID
weaponName：武器名
weaponType：武器種別（例：E_WeaponType_Sword など）

なお、武器プールにおける seq_id の仕様はキャラクタープールと同様であり、すべての武器サブプールで同一のシーケンスを共有する。

以上で、『アークナイツ：エンドフィールド』におけるガチャ履歴APIの仕様は概ね整理できた。

実装の基本方針

これらを踏まえると、有効なガチャ履歴URLを利用して、全プールのデータを取得する方法は以下のように整理できる。

キャラクタープール

任意の pool_type を指定し、seq_id を付与せずにリクエストを送信し、最新データを取得する。
取得結果の最小 seqId をカーソルとして使用し、古い順にページングしていく。
hasMore === false になる、またはデータが取得できなくなるまで繰り返す。
別の pool_type に切り替えて同様の処理を行う。

武器プール

武器プール一覧APIを呼び出す。
各プールごとに履歴APIを巡回取得する。
poolId に constant を含むかどうかでプール種別を判定する。

コード実装

CodeBlock Loading...

これで『アークナイツ：エンドフィールド』のすべてのプールの記録を取得する機能が実装できた。

以下では、その実装に至るまでの基本的な考え方をまとめている。同様の機能を実装したい方の参考になれば幸いだ。

URLに含まれる情報

まず、他のゲームと同様に、パケットキャプチャツールを用いることで、以下のようなガチャ履歴のAPIリンクを取得できる：

TEXT

https://ef-webview.hypergryph.com/api/record/char?lang=zh-cn&seq_id={seqId}&pool_type={poolType}&token={token}&server_id={serverId}

キャラクタープール

キャラクタープールでは、主に pool_type と seq_id の2つのパラメータに注目する。

pool_type はガチャプールの列挙値であり、現時点では以下のいずれかを取る：

出発スカウト（初心者プール）：E_CharacterGachaPoolType_Beginner
通常スカウト（恒常プール）：E_CharacterGachaPoolType_Standard
限定スカウト（期間限定プール）：E_CharacterGachaPoolType_Special

また、『原神』や『鳴潮』などとは異なり、エンドフィールドのガチャ履歴リンクには通常 seq_id パラメータが付与されている。

JSON

// seq_id=26&pool_type=E_CharacterGachaPoolType_Standard
{
  "code": 0,
  "data": {
    "list": [
      //...
      {
        "poolId": "standard",
        "poolName": "通常スカウト",
        "charId": "chr_0019_karin",
        "charName": "秋栗",
        "rarity": 4,
        "isFree": false,
        "isNew": false,
        "gachaTs": "1769073164712",
        "seqId": "21"
      }
    ],
    "hasMore": false
  },
  "msg": ""
}

// pool_type=E_CharacterGachaPoolType_Beginner
{
  "code": 0,
  "data": {
    "list": [
      {
        "poolId": "beginner",
        "poolName": "出発スカウト",
        "charId": "chr_0022_bounda",
        "charName": "蛍石",
        "rarity": 4,
        "isFree": false,
        "isNew": false,
        "gachaTs": "1769072324787",
        "seqId": "20" // 当該プールにおける最新のガチャ記録
      },
      // ...
    ],
    "hasMore": true
  },
  "msg": ""
}

CodeBlock Loading...

これら2つの異なるプールのデータを観察すると、seq_id パラメータには以下のような特徴があることが分かる：

seq_id (seqId) はアカウント単位で管理される増加シーケンスであり、サブプールをまたいで共有される。ただし、キャラクタープールと武器プールではそれぞれ独立したシーケンスを持つ。同一タイプ内（すべてのキャラクタープール、またはすべての武器プール）では、サブプールを切り替えてもカウントはリセットされない。
数値が大きいほど、より新しい記録である。
リクエストに seq_id を含めない場合、そのプールにおける最新5件の記録（最大の seqId）が返される。

武器プール

武器プールのAPIはキャラクタープールとは異なり、2段階でデータを取得する必要がある。

武器プール一覧の取得

まず、以下のAPIでユーザーがガチャ履歴を持つ武器プール一覧を取得する：

TEXT

https://ef-webview.hypergryph.com/api/record/weapon/pool?lang=zh-cn&token={token}&server_id={serverId}

CodeBlock Loading...

JSON

{
  "code": 0,
  "data": [
    { "poolId": "weponbox_1_0_1", "poolName": "熔铸申领" },
    { "poolId": "weaponbox_constant_2", "poolName": "星声申领" }
  ],
  "msg": ""
}

CodeBlock Loading...

武器プールは大きく以下の2種類に分類される：

限定武器プール：poolId が weponbox_*
恒常武器プール：poolId が weaponbox_constant_*

余談だが、限定武器プールの poolId に含まれる wepon はスペルミスと思われる。

武器ガチャ履歴の取得

各武器プールの履歴は、以下のAPIで取得する：

TEXT

https://ef-webview.hypergryph.com/api/record/weapon?lang=zh-cn&seq_id={seqId}&pool_id={poolId}&token={token}&server_id={serverId}

CodeBlock Loading...

JSON

{
  "code": 0,
  "data": {
    "list": [
      {
        "poolId": "weponbox_1_0_1",
        "poolName": "熔铸申领",
        "weaponId": "wpn_funnel_0010",
        "weaponName": "騎士精神",
        "weaponType": "E_WeaponType_Wand",
        "rarity": 6,
        "isNew": true,
        "gachaTs": "1769238381938",
        "seqId": "47"
      }
    ],
    "hasMore": true
  },
  "msg": ""
}

CodeBlock Loading...

武器データのフィールドはキャラクターと若干異なり、以下が追加されている：

weaponId：武器ID
weaponName：武器名
weaponType：武器種別（例：E_WeaponType_Sword など）

なお、武器プールにおける seq_id の仕様はキャラクタープールと同様であり、すべての武器サブプールで同一のシーケンスを共有する。

以上で、『アークナイツ：エンドフィールド』におけるガチャ履歴APIの仕様は概ね整理できた。

実装の基本方針

これらを踏まえると、有効なガチャ履歴URLを利用して、全プールのデータを取得する方法は以下のように整理できる。

キャラクタープール

任意の pool_type を指定し、seq_id を付与せずにリクエストを送信し、最新データを取得する。
取得結果の最小 seqId をカーソルとして使用し、古い順にページングしていく。
hasMore === false になる、またはデータが取得できなくなるまで繰り返す。
別の pool_type に切り替えて同様の処理を行う。

武器プール

武器プール一覧APIを呼び出す。
各プールごとに履歴APIを巡回取得する。
poolId に constant を含むかどうかでプール種別を判定する。

コード実装

// キャラクタープール記録の取得
async function fetchCharacterRecords(token: string, serverId: string) {
  const poolTypes = [
    "E_CharacterGachaPoolType_Beginner",
    "E_CharacterGachaPoolType_Standard",
    "E_CharacterGachaPoolType_Special",
  ];
  const allRecords = [];

  for (const poolType of poolTypes) {
    let cursor = null;
    let hasMore = true;

    while (hasMore) {
      const seqIdParam = cursor !== null ? `&seq_id=${cursor}` : "";
      const url = `https://ef-webview.hypergryph.com/api/record/char?lang=zh-cn${seqIdParam}&pool_type=${poolType}&token=${encodeURIComponent(token)}&server_id=${serverId}`;
      
      const response = await fetch(url);
      const { data } = await response.json();

      if (data?.list?.length > 0) {
        allRecords.push(...data.list);
        hasMore = data.hasMore;
        
        if (hasMore) {
          const seqIds = data.list.map(item => Number(item.seqId));
          cursor = Math.min(...seqIds);
          await new Promise(resolve => setTimeout(resolve, 300));
        }
      } else {
        hasMore = false;
      }
    }
  }

  return allRecords;
}

// 武器プール記録の取得
async function fetchWeaponRecords(token: string, serverId: string) {
  const allRecords = [];
  const poolListUrl = `https://ef-webview.hypergryph.com/api/record/weapon/pool?lang=zh-cn&token=${encodeURIComponent(token)}&server_id=${serverId}`;
  const poolListResponse = await fetch(poolListUrl);
  const { data: weaponPools } = await poolListResponse.json();

  if (!weaponPools?.length) return allRecords;

  for (const pool of weaponPools) {
    let cursor = null;
    let hasMore = true;

    while (hasMore) {
      const seqIdParam = cursor !== null ? `&seq_id=${cursor}` : "";
      const url = `https://ef-webview.hypergryph.com/api/record/weapon?lang=zh-cn${seqIdParam}&pool_id=${pool.poolId}&token=${token}&server_id=${serverId}`;
      
      const response = await fetch(url);
      const { data } = await response.json();

      if (data?.list?.length > 0) {
        allRecords.push(...data.list);
        hasMore = data.hasMore;
        
        if (hasMore) {
          const seqIds = data.list.map(item => Number(item.seqId));
          cursor = Math.min(...seqIds);
          await new Promise(resolve => setTimeout(resolve, 300));
        }
      } else {
        hasMore = false;
      }
    }
  }

  return allRecords;
}

CodeBlock Loading...

これで『アークナイツ：エンドフィールド』のすべてのプールの記録を取得する機能が実装できた。