今後仕様が急に変わる場合がありますのでご注意ください。
スプラトゥーン3の各種情報を返すapiを公開します。
8/27 自動アクセスに対する制限が厳しいため、公開を終了します。
gtokenをブラウザで取得するを利用して画面で見るか、gtoken自動取得のためのapi公開を利用してapiに対して自身でアクセスしてください。
APIURL:https://api.koukun.jp/splatoon/3/
レスポンスContent-type：application/json; charset=utf-8
全てjson形式です。
リクエストはGETです。
パラメータを指定となっている場合は/の後に?をつけてパラメータをつけてください。
例：schedulesでの画像指定： schedules/?image=true
時間が入っている場合、その時刻は日本時間です。
時刻の形式は”YYYY-MM-dd HH:mm:ss”で、unixとついたものはunixタイムスタンプです。
署名情報が入っているため、画像のurlは削除されています。
→2023/03/31 schedules、schedules/coop、stageについては、パラメータにimage=trueをつけることで画像のurlを表示するようにしました。
→2023/05/23 weapon、fes、geso(ギアパワー除く)についても同様にimage=trueをつけることで画像のurlを表示するようにしました。
アクセス制限について
このapiは日本国内からのみアクセスできます。
ただし、OCI(Oracle Cloud)環境については日本のサーバーであっても日本判定されませんので、403エラーが出た場合はコメントにてipアドレスと共にお知らせください。
2023/03/27 スケジュール取得にパラメータを指定出来るようになりました。
2023/03/31 schedules、schedules/coop、stageについてレスポンスが重たかった現象を改善しました。
2023/05/23 武器一覧(weapon)をこのページに載せるのを忘れていたので追加しました。
CORSに対応しました。
サーモンランスケジュールにて、バイトチームコンテスト(teamcontest)を追加しました。
2023/05/31 schedulesからリーグマッチが削除されました。互換性のため項目のみ残しますがデータが入ることはありません。
2023/06/01 schedulesにイベントマッチ(event)を追加しました。
ロビースケジュール
URL:schedules/
仕様詳細
regular レギュラーマッチ
bankara バンカラマッチ
xmatch Xマッチ
event イベントマッチ
fes フェスマッチ
data : true or false trueの時はフェスデータが入っています
trueになるのはフェス開始1日前から終了までです
パラメータによる絞り込み
ルール指定：?rule=<ルール名>
例：?rule=regularでナワバリバトルのスケジュールのみ取得できます。
返却個数指定：?count=<値>
1を指定すると1つの時間帯のみ取得できます。
開始位置指定：?start=<値>
1を指定すると今の時間帯を飛ばして次のスケジュールから取得できます。
例：?rule=xmatch&start=1&count=1 で次の時間帯のXマッチのスケジュールのみ取得します。
値に間違った値が指定された場合は無視されます。
今のスケジュールのみ
URL:schedules/now/
schedules/?count=1にリダイレクト
サーモンランスケジュール
URL:schedules/coop/
ステージ一覧
URL:stage/
武器一覧
URL:weapon/
カタログ
URL:catalog/
ゲソタウン
URL:geso/
フェス一覧(メンテナンス中)
URL:fes/
コメント
各ルールのXマッチランキング一覧と武器トッププレイヤー一覧も可能でしょうか？
7月を目途に追加します。
こちらのAPI昨日までアクセス出来ていたのですが、本日はレスポンスが返ってこずにタイムアウトしてしまうのですがホスト側の問題でしょうか？
フェスもできればお願いしたいです。
できればでいいのでお願いします！
weapon、及びfesでの画像表示に対応しました。
weaponsにも画像がほしいのですが可能ですか？
コメント失礼します。
Linuxosから取得しようとすると、KeyError: ‘stage’が帰ってきてしまい、取得が出来ません。windowsでは問題なく取得できました。
正しくapiから情報を取得出来ていないと思います。
レスポンスコードが200であるかを確認してください。
ip制限などにより403などになっている場合があります。
返信遅くなり申し訳ございません。
現在試したところ、403エラーが確認できました。
この場合どのように対処すれば良いのでしょうか…?
一時的にip制限を外しましたのでアクセスできるかお試しください。(～4/5 18:00ごろ)
これ以降アクセスする場合はipアドレスを教えてください。
制限から除外します。
現在試したところ、アクセスできました。
今後も定期的にアクセスしたいのですが可能でしょうか？
ipアドレスは [削除] です、よろしくお願いいたします。
除外リストに登録しました。
日本のipのみアクセスできるように制限をかけているのですが、少しもれてしまう不具合があり、海外判定されていました。
以後は403エラーは出ませんのでご利用ください。
こんにちは。
サーモンランで、”bigrun”の”weapons”の前に余分な{が入っている気がします。
コメントありがとうございます。修正しました。次回より反映されます。