ゲーム記録
ゲーム記録は公式ゲームのスナップショットで、Haneoka のアカウントプールが収集します。読み取りはすべて公開で、キーは不要です。
各地域は別々のゲームサーバーなので、リクエストには region を使います。
| region | サーバー |
|---|---|
jp | JP |
tw | TW/HK/MO |
en | EN Regions |
kr | KR |
tw、en、kr はいずれも Global カタログを共有します。
保留中の応答
Section titled “保留中の応答”データは保存済みスナップショットから読むため、リクエストがゲームを待つことはありません。未収集の場合はキューに入れ 503 を返します。
{ "error": { "kind": "pending", "retryAfter": 30 } }retryAfter 秒待ってから同じリクエストを送ってください。多くは数分以内に完了します。
現在のイベント
Section titled “現在のイベント”開催中のイベント、期間、ランキングの種類。イベントがないときは event が null です。
/api/v1/game/records/{region}/events/current イベントランキング
Section titled “イベントランキング”総合ランキングまたは課題曲ランキングの上位 100 名と編成。
/api/v1/game/records/{region}/events/{eventId}/total/latest イベントポイントランキング
Section titled “イベントポイントランキング”ポイントを競うイベントには三つ目のランキングがあります。行は point を持ち、編成はありません。それ以外のイベントは 404 を返します。
/api/v1/game/records/{region}/events/{eventId}/latest 100 位以降
Section titled “100 位以降”100 位ずつ読み取ります。start はその窓の先頭にそろえられ、maxRank は最終順位が分かるまで null です。search はプレイヤー ID で上位 2000 位を探します。窓はイベントにポイントランキングがある間だけ収集されます。
/api/v1/game/records/{region}/events/{eventId}/points/ranking /api/v1/game/records/{region}/events/{eventId}/points/search 楽曲ランキング
Section titled “楽曲ランキング”1 曲の上位 100 名。
/api/v1/game/records/{region}/songs/{musicId}/ranking 激奏アリーナ
Section titled “激奏アリーナ”リーグのランキングを 100 行ずつ。bandId はリーグのバンド、start は順位です。
/api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/ranking ポイント帯ごとの人数
Section titled “ポイント帯ごとの人数”各しきい値以上のプレイヤー数を数えます。初回は 202 を返すので、Retry-After 秒後に再試行してください。
/api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/population プレイヤーを探す
Section titled “プレイヤーを探す”上位 searchedTo 位の中からゲーム内 ID を探します。範囲外なら row は null です。
/api/v1/game/records/{region}/arena/seasons/{seasonId}/leagues/{bandId}/search ゲーム内に表示される ID で公開プロフィールを読みます。
/api/v1/game/records/{region}/players/{profileId} 初回は pending を返すことがあります。記録は 6 時間後に更新されます。
JavaScript で
Section titled “JavaScript で”{ "error": { "kind": "pending", "retryAfter": 30 } }