Spla2 API

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

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

概要

スプラトゥーンのステージ情報がとれるやつ（非公式）をベースにした splapi を参考に作成しています。
スプラトゥーン2のステージ情報・サーモンランの情報を取得できます。
取得可能期間は、2017/07/20(発売前日)以降のステージ情報、2017/11/09以降のサーモンラン情報です。

注意事項

このAPIは非公式ですので公式への問い合わせはお控えください。
バグやサーバ障害、大人の事情等により突然停止する可能性があります。
正しいステージ情報が取得できているはずですが、内容の保証はできません。
(スプラトゥーン2 ステージ情報bot と同じデータベースを使用しています)

現時点では、フェス開催時も通常通りのデータを返しますのでご注意下さい。
レギュラーマッチのステージ2つ＋「ミステリーゾーン」で、フェスのステージ情報になります。
日本語および日本時間 (UTC +09:00) にしか対応していません。
短時間での大量アクセスは行わないでください。目に余る場合は、予告なしでブロックします。

利用方法

プロトコルは 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

指定した時間帯のステージ情報を返します。

https://spla2.yuu26.com/{p1}/{p2}

p1: `{regular|gachi|league}`
regular	レギュラーマッチ
gachi	ガチマッチ
league	リーグマッチ

p2: `{now|next|next_all|schedule}`
now	現在のステージ情報
next	次のステージ情報
next_all	次～最大24時間先までのステージ情報 (`next` を含む)
schedule	現在～最大24時間先までのステージ情報 (`now` + `next_all`)

形式2

過去～未来（最大24時間先）の全ステージ情報を返します。

https://spla2.yuu26.com/{p1}

p1: `{regular|gachi|league}`
regular	レギュラーマッチ
gachi	ガチマッチ
league	リーグマッチ

形式3

現在～最大24時間先までのステージ情報を全ルール分まとめて返します。

https://spla2.yuu26.com/schedule

形式4

サーモンランのスケジュール情報を返します。/schedule を付けると、現在～未来のスケジュールのみ返します。

過去～直近の2件については、ステージ情報・支給ブキ情報が含まれています。

https://spla2.yuu26.com/coop

https://spla2.yuu26.com/coop/schedule

利用例

レギュラーマッチ（ナワバリ）の全期間 ※重いです	https://spla2.yuu26.com/regular
現在のガチマッチ	https://spla2.yuu26.com/gachi/now
次のリーグマッチ	https://spla2.yuu26.com/league/next
現在以降の全ステージ情報	https://spla2.yuu26.com/schedule
現在以降のサーモンラン情報	https://spla2.yuu26.com/coop/schedule

レスポンスデータ例

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

また、rule, maps については互換性のためのデータです。可能であれば、rule_ex, maps_ex の利用をお勧めします。

形式1, 2の場合

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

rule: ルールの名称
rule_ex: ルールの詳細情報

key: ルールの内部Key
name: ルールの名称
statink: stat.ink 内の識別子

maps: ステージの名称
maps_ex: ステージの詳細情報

id: ステージの内部ID
name: ステージの名称
image: ステージの画像 URL
statink: stat.ink 内の識別子

start, start_utc, start_t: ステージの開始時刻
end, end_utc, end_t: ステージの終了時刻

形式3の場合

result: 最上位の階層です。形式1,2の時とは異なり配列ではありません。

regular: レギュラーマッチの情報（形式1, 2と同様のフォーマット）
gachi: ガチマッチの情報（形式1, 2と同様のフォーマット）
league: リーグマッチの情報（形式1, 2と同様のフォーマット）

形式4の場合（サーモンラン）

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

start, start_utc, start_t: バイトの開始時刻
end, end_utc, end_t: バイトの終了時刻
stage: ステージ情報（※直近2件のみ、3件目以降はNULL）

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

weapons: 支給ブキ情報の配列（※直近2件のみ、3件目以降はNULL）

id: 支給ブキの ID
image: 支給ブキの画像 URL
name: 支給ブキの名称

Key, ID 一覧

ルール Key

`turf_war`	ナワバリバトル
`splat_zones`	ガチエリア
`tower_control`	ガチヤグラ
`rainmaker`	ガチホコバトル
`clam_blitz`	ガチアサリ

ステージ ID

`0`	バッテラストリート
`1`	フジツボスポーツクラブ
`2`	ガンガゼ野外音楽堂
`3`	チョウザメ造船
`4`	海女美術大学
`5`	コンブトラック
`6`	マンタマリア号
`7`	ホッケふ頭
`8`	タチウオパーキング
`9`	エンガワ河川敷
`10`	モズク農園
`11`	Ｂバスパーク
`12`	デボン海洋博物館
`13`	ザトウマーケット
`14`	ハコフグ倉庫
`15`	アロワナモール
`16`	モンガラキャンプ場
`17`	ショッツル鉱山
`18`	アジフライスタジアム
`19`	ホテルニューオートロ
`20`	スメーシーワールド
`21`	アンチョビットゲームズ
`22`	ムツゴ楼
`9999`	ミステリーゾーン

フェス ID

`1051`	「マヨネーズ」vs「ケチャップ」
`1052`	「マックポテト」vs「マックナゲット」
`1054`	「瞬発力」vs「持久力」
`1055`	「レモンかける」vs「レモンかけない」
`1056`	「あったかインナー」vs「あったかアウター」
`4051`	「アクション」vs「コメディ」
`1057`	「チャンピオン」vs「チャレンジャー」
`1058`	「花」vs「団子」
`1059`	「最新モデル」vs「人気モデル」
`1060`	「未知の生物」vs「先進の技術」
`1061`	「ハローキティ」vs「シナモロール」
`1062`	「マイメロディ」vs「ポムポムプリン」
`1063`	「ハローキティ」vs「マイメロディ」
`4052`	「イカ」vs「タコ」
`1065`	「きのこの山」vs「たけのこの里」
`1066`	「つぶあん」vs「こしあん」
`4053`	「トリック」vs「トリート」
`1067`	「ポッキーチョコレート」vs「ポッキー＜極細＞」
`4054`	「ヒーロー」vs「ヴィラン」
`4055`	「家族」vs「仲間」
`1068`	「ボケ」vs「ツッコミ」
`4056`	「騎士」vs「魔法使い」
`4057`	「ウサギ」vs「カメ」
`1069`	「セ」vs「パ」
`1070`	「パインはナシ」vs「パインはアリ」
`4058`	「混沌」vs「秩序」
`4061`	「マヨネーズ」vs「ケチャップ」

更新履歴

2017/08/09: 公開
2017/08/10: rule_ex->key および maps_ex->id を追加
2017/08/26: Key, ID 一覧を更新
2017/09/21: ID 一覧を更新
2017/10/07: ID 一覧を更新
2017/11/09: サーモンランの API を追加
2017/11/11: サーモンランの支給ブキ情報に対応
2017/11/19: エラー時の挙動を整理
2017/12/18: ID 一覧を更新
2018/02/04: Key, ID 一覧を更新
2018/02/25: ID 一覧を更新
2018/05/12: ID 一覧を更新、サーバ増強実施
2018/06/03: ID 一覧を更新
2018/08/05: ID 一覧を更新
2018/09/22: ID 一覧を更新
2018/10/07: ID 一覧を更新、サーモンランのブキ「？」の画像修正
2018/11/11: ID 一覧を更新、ステージの画像 URL を追加
2019/07/06: ID 一覧を更新、statink 情報に対応
2020/05/23: ID 一覧を更新

その他

まだまだ開発中のため、不具合が残っている可能性もあります。ご指摘頂けると嬉しいです。

作者に連絡を取る際は、ブログ記事にコメント、もしくは Twitter(@m_on_yu) までお願いします。