Spla3 API

スプラトゥーン3のステージ情報・サーモンラン情報を取得できる API です。

あくまで個人用に作成したものですが、ご自由にお使いください。 Spla2 API はこちら

概要

スプラトゥーン3のステージ情報・サーモンランの情報を取得できるAPIです。
取得可能期間は、2022/09/09 (発売日) 以降のステージ情報およびサーモンラン情報です。

注意事項

API仕様が変わったり提供を停止する可能性があります。
このAPIは非公式ですので公式への問い合わせはお控えください。
システムトラブル等により接続できない場合があります。
正しいステージ情報が取得できているはずですが、内容の保証はできません。
(スプラトゥーン3 ステージ情報bot と同じデータを使用しています)
フェス開催時はレギュラーマッチとバンカラマッチのステージ情報が配信されません。フェスマッチのデータをご利用ください。
短時間での大量アクセスは行わないでください。

利用方法

プロトコルは HTTP/3 HTTP/2 HTTP/1.1 が利用可能です。
リクエストには GET メソッドを使用してください。
HTTP でアクセスした場合は HTTPS にリダイレクトされます。
レスポンスの Content-Type は application/json;charset=utf-8 です。
エラーの場合は JSON 以外を返却する可能性がありますので、レスポンスコード 200 を確認後にパースすることをお勧めします。
プログラムに組み込む際は、User-Agent をなるべく設定してください。連絡先を含めるようにお願いします。
記載の形式は問いません。(例: Ikabot/1.0(twitter@アカウント名) IkaGirl/2.0(https://example.com/) など)

形式1 (推奨)

現在～最大12個先までのステージ情報を全ルール分まとめて返します。(サーモンラン除く)

https://spla3.yuu26.com/api/schedule

形式2

指定した条件でステージ情報を返します。

https://spla3.yuu26.com/api/{p1}/{p2}

p1: `{regular|bankara-open|bankara-challenge|fest|fest-challenge|x|coop-grouping|coop-grouping-team-contest|event}`
regular	レギュラーマッチ
bankara-open	バンカラマッチ(オープン)
bankara-challenge	バンカラマッチ(チャレンジ)
fest	フェスマッチ(オープン)
fest-challenge	フェスマッチ(チャレンジ)
x	Xマッチ
event	イベントマッチ
coop-grouping	サーモンラン ※従来の `coop-grouping-regular` は非推奨となりました
coop-grouping-team-contest	サーモンラン(バイトチームコンテスト)

p2: `{now|next|schedule}`　※イベントマッチ・バイトチームコンテストは `schedule` のみ対応
now	現在のステージ情報
next	次のステージ情報
schedule	今後のステージ情報 (最大12個先まで)

利用例

全ステージ情報をまとめて取得	https://spla3.yuu26.com/api/schedule
現在のレギュラーマッチ	https://spla3.yuu26.com/api/regular/now
次のバンカラマッチ(オープン)	https://spla3.yuu26.com/api/bankara-open/next
今後のバンカラマッチ(チャレンジ)	https://spla3.yuu26.com/api/bankara-challenge/schedule
今後のXマッチ	https://spla3.yuu26.com/api/x/schedule
今後のイベントマッチ	https://spla3.yuu26.com/api/event/schedule
今後のフェスマッチ(オープン)	https://spla3.yuu26.com/api/fest/schedule
今後のフェスマッチ(チャレンジ)	https://spla3.yuu26.com/api/fest-challenge/schedule
今後のサーモンラン	https://spla3.yuu26.com/api/coop-grouping/schedule
今後のバイトチームコンテスト	https://spla3.yuu26.com/api/coop-grouping-team-contest/schedule

レスポンスデータ例

下記の例では、読み取りやすさのために改行やインデントを追加しています。実際のデータには含まれていません。

ステージ情報

results: 最上位の階層で、常に配列です。

start_time: 開始時刻
end_time: 終了時刻
rule: ルール情報　※フェス開催時は null

key: ルールKey
name: ルール名

stages: ステージ情報　※フェス開催時は null

id: ステージID
name: ステージ名
image: ステージ画像URL

event: イベント情報　※イベントマッチのみ

id: イベントID
name: イベント名
desc: イベント説明

is_fest: フェス開催有無

フェスステージ情報

results: 最上位の階層で、常に配列です。

start_time: 開始時刻
end_time: 終了時刻
rule: ルール情報　※非開催時は null

key: ルールKey
name: ルール名

stages: ステージ情報　※非開催時は null

id: ステージID
name: ステージ名
image: ステージ画像URL

is_fest: フェスの開催有無
is_tricolor: トリカラバトルの開催有無
tricolor_stages: トリカラバトルのステージ情報　※非開催時は null

name: ステージ名
image: ステージ画像URL

サーモンラン情報

results: 最上位の階層で、常に配列です。

start_time: 開始時刻
end_time: 終了時刻
boss: オカシラシャケ情報

id: ID
name: 名前

stage: ステージ情報

id: ステージID　※現在はすべて0
name: ステージ名
image: ステージ画像URL

weapons: ブキ情報

name: ブキ名
image: ブキ画像URL

is_big_run: ビッグランの有無

一括取得の場合

result: 最上位の階層です。他のエンドポイントとは異なり配列ではありません。

regular: レギュラーマッチの情報
bankara_challenge: バンカラマッチ(チャレンジ)の情報
bankara_open: バンカラマッチ(オープン)の情報
x: Xマッチの情報
event: イベントマッチの情報
fest: フェスマッチ(オープン)の情報
fest: フェスマッチ(チャレンジ)の情報

Key/ID一覧

ルールKey

`TURF_WAR`	ナワバリバトル
`AREA`	ガチエリア
`LOFT`	ガチヤグラ
`GOAL`	ガチホコバトル
`CLAM`	ガチアサリ

ステージID

`1`	ユノハナ大渓谷
`2`	ゴンズイ地区
`3`	ヤガラ市場
`4`	マテガイ放水路
`5`	ナンプラー遺跡
`6`	ナメロウ金属
`7`	クサヤ温泉
`8`	タラポートショッピングパーク
`9`	ヒラメが丘団地
`10`	マサバ海峡大橋
`11`	キンメダイ美術館
`12`	マヒマヒリゾート＆スパ
`13`	海女美術大学
`14`	チョウザメ造船
`15`	ザトウマーケット
`16`	スメーシーワールド
`17`	コンブトラック
`18`	マンタマリア号
`19`	タカアシ経済特区
`20`	オヒョウ海運

更新履歴

2022/09/09: 公開
2022/09/14: レスポンスデータ例、Key/ID一覧を追加
2022/09/14: CORS対応
2022/09/17: サーモンラン対応
2022/09/23: フェスマッチ対応
2022/11/15: Xマッチ対応
2022/11/30: ID一覧更新
2022/12/04: ビッグラン対応、一部エンドポイント名変更
2023/04/14: バイトチームコンテスト対応
2023/06/03: イベントマッチ対応
2023/06/16: ID一覧更新
2023/09/08: フェスマッチ(チャレンジ)対応、ID一覧更新
2023/12/04: サーモンランのオカシラシャケ追加
2024/10/27: トリカラバトルの複数ステージ対応

その他

作者に連絡を取る際は、Twitter(@m_on_yu) もしくは問い合わせフォームまでお願いします。