スプラトゥーン3 API公開

今後仕様が急に変わる場合がありますのでご注意ください。

スプラトゥーン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/

コメント

  1. ぶりとー より:

    こちらのAPI昨日までアクセス出来ていたのですが、本日はレスポンスが返ってこずにタイムアウトしてしまうのですがホスト側の問題でしょうか?

  2. より:

    フェスもできればお願いしたいです。
    できればでいいのでお願いします!

  3. より:

    weaponsにも画像がほしいのですが可能ですか?

  4. zbub より:

    コメント失礼します。
    Linuxosから取得しようとすると、KeyError: ‘stage’が帰ってきてしまい、取得が出来ません。windowsでは問題なく取得できました。

    • koukun より:

      正しくapiから情報を取得出来ていないと思います。
      レスポンスコードが200であるかを確認してください。
      ip制限などにより403などになっている場合があります。

      • zbub より:

        返信遅くなり申し訳ございません。
        現在試したところ、403エラーが確認できました。
        この場合どのように対処すれば良いのでしょうか…?

        • koukun より:

          一時的にip制限を外しましたのでアクセスできるかお試しください。(~4/5 18:00ごろ)
          これ以降アクセスする場合はipアドレスを教えてください。
          制限から除外します。

          • zbub より:

            現在試したところ、アクセスできました。
            今後も定期的にアクセスしたいのですが可能でしょうか?
            ipアドレスは [削除] です、よろしくお願いいたします。

          • koukun より:

            除外リストに登録しました。
            日本のipのみアクセスできるように制限をかけているのですが、少しもれてしまう不具合があり、海外判定されていました。
            以後は403エラーは出ませんのでご利用ください。

  5. なかとも より:

    こんにちは。
    サーモンランで、”bigrun”の”weapons”の前に余分な{が入っている気がします。

タイトルとURLをコピーしました