今後仕様が急に変わる場合がありますのでご注意ください。
スプラトゥーン3の各種情報を返す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/
コメント
フェスもできればお願いしたいです。
できればでいいのでお願いします！
weapon、及びfesでの画像表示に対応しました。
weaponsにも画像がほしいのですが可能ですか？
コメント失礼します。
Linuxosから取得しようとすると、KeyError: ‘stage’が帰ってきてしまい、取得が出来ません。windowsでは問題なく取得できました。
正しくapiから情報を取得出来ていないと思います。
レスポンスコードが200であるかを確認してください。
ip制限などにより403などになっている場合があります。
返信遅くなり申し訳ございません。
現在試したところ、403エラーが確認できました。
この場合どのように対処すれば良いのでしょうか…?
一時的にip制限を外しましたのでアクセスできるかお試しください。(～4/5 18:00ごろ)
これ以降アクセスする場合はipアドレスを教えてください。
制限から除外します。
現在試したところ、アクセスできました。
今後も定期的にアクセスしたいのですが可能でしょうか？
ipアドレスは [削除] です、よろしくお願いいたします。
除外リストに登録しました。
日本のipのみアクセスできるように制限をかけているのですが、少しもれてしまう不具合があり、海外判定されていました。
以後は403エラーは出ませんのでご利用ください。
こんにちは。
サーモンランで、”bigrun”の”weapons”の前に余分な{が入っている気がします。
コメントありがとうございます。修正しました。次回より反映されます。