サーモンランAPI

スプラトゥーン2 サーモンランのシフト情報を返すAPI
サーモンラン研究所が収集しているデータを利用した非公式APIです。
Splatoon2バトルステージのAPIは「スプステージ2」をお使いください。
目次
- サーモンランAPIの特長
- 仕様
- API① : シフト表形式「now」
- API② : 全履歴一覧形式「all」
- API①②の値について
- おまけデータ:「報酬ギア」
- サンプルコード
- このAPIを使ったアプリ
- 更新履歴
サーモンランAPIの特長
シフト表相当のデータを返す「now」形式、全開催履歴のデータを返す「all」形式の2種類が利用できます。
初回から全ての回を記録しています。第何回の開催なのかもわかります。
英語データ、日本語データ、イカリング2内部キーの値、画像URLも取得できます。
仕様
データはステージ変更の5秒後くらいに更新されます。
前回の更新日時:2023/10/02 03:00:07
レスポンスヘッダ
Content-Type: application/json; charset=utf-8
レスポンスはJSON形式で、文字コードはUTF-8です。
Access-Control-Allow-Origin: *
このAPIはCORSにより全てのオリジンからのアクセスを許可しているため、JavaScriptでも利用することができます。
API① : シフト表形式「now」
https://splamp.info/salmon/api/now
botの作成やシフト表の表示などに便利な形式です。
イカリング2の「シフト表」と同様に、現在時刻から未来の順番で出力されます。
レスポンス例
[ { num: 370, start: 1558677600, end: 1558807200, stage: 1, stage_ja: "シェケナダム", stage_en: "Spawning Grounds", stage_img: "https://app.splatoon2.nintendo.net/images/coop_stage/65c68c6f0641cc5654434b78a6f10b0ad32ccdee.png", w1: "5020", w1_ja: "ケルビン525", w1_en: "Glooga Dualies", w1_img: "https://app.splatoon2.nintendo.net/images/weapon/7d6032f0ceee14c4607385b848c6e486b84a2865.png", w2: "6020", w2_ja: "スパイガジェット", w2_en: "Undercover Brella", w2_img: "https://app.splatoon2.nintendo.net/images/weapon/15fe3fe6bbec24ddb5fdc3ffd06585bc82440531.png", w3: "3000", w3_ja: "バケットスロッシャー", w3_en: "Slosher", w3_img: "https://app.splatoon2.nintendo.net/images/weapon/3963a3fb1ff8038a42072e913587fc6f9aa00d71.png", w4: "4010", w4_ja: "バレルスピナー", w4_en: "Heavy Splatling", w4_img: "https://app.splatoon2.nintendo.net/images/weapon/6f42c9f8fde07510a01072a669125545f6effb99.png" }, { num: 371, start: 1558828800, end: 1558980000, stage: 5, stage_ja: "朽ちた箱舟 ポラリス", stage_en: "Ruins of Ark Polaris", stage_img: "https://app.splatoon2.nintendo.net/images/coop_stage/50064ec6e97aac91e70df5fc2cfecf61ad8615fd.png", w1: "1010", w1_ja: "スプラローラー", w1_en: "Splat Roller", w1_img: "https://app.splatoon2.nintendo.net/images/weapon/1041dbdd11b3036671148d47c2e0798cecf3dba2.png", w2: "5000", w2_ja: "スパッタリー", w2_en: "Dapple Dualies", w2_img: "https://app.splatoon2.nintendo.net/images/weapon/cc4bc30ff53bf2b45bd5e3dadceb39d52b95761f.png", w3: "70", w3_ja: "プライムシューター", w3_en: "Splattershot Pro", w3_img: "https://app.splatoon2.nintendo.net/images/weapon/2e2b59379b8f14cfed0600f84590be0ecad707b6.png", w4: "6010", w4_ja: "キャンピングシェルター", w4_en: "Tenta Brella", w4_img: "https://app.splatoon2.nintendo.net/images/weapon/cdb032aa993f4836580ce4edac06de0138833299.png" }, { num: 372, start: 1559001600, end: 1559131200 }, { num: 373, start: 1559152800, end: 1559282400 }, { num: 374, start: 1559304000, end: 1559455200 } ]
API② : 全履歴一覧形式「all」
https://splamp.info/salmon/api/all
サーモンレックのトップ画面のようなシフト一覧表示に便利な形式です。
「now」と異なり、未来から過去の順番で出力されます。逆順なので注意してください。
レスポンス例
[ { num: 374, start: 1559304000, end: 1559455200 }, { num: 373, start: 1559152800, end: 1559282400 }, { num: 372, start: 1559001600, end: 1559131200 }, { num: 371, start: 1558828800, end: 1558980000, stage: 5, stage_ja: "朽ちた箱舟 ポラリス", stage_en: "Ruins of Ark Polaris", stage_img: "https://app.splatoon2.nintendo.net/images/coop_stage/50064ec6e97aac91e70df5fc2cfecf61ad8615fd.png", w1: "1010", w1_ja: "スプラローラー", w1_en: "Splat Roller", w1_img: "https://app.splatoon2.nintendo.net/images/weapon/1041dbdd11b3036671148d47c2e0798cecf3dba2.png", w2: "5000", w2_ja: "スパッタリー", w2_en: "Dapple Dualies", w2_img: "https://app.splatoon2.nintendo.net/images/weapon/cc4bc30ff53bf2b45bd5e3dadceb39d52b95761f.png", w3: "70", w3_ja: "プライムシューター", w3_en: "Splattershot Pro", w3_img: "https://app.splatoon2.nintendo.net/images/weapon/2e2b59379b8f14cfed0600f84590be0ecad707b6.png", w4: "6010", w4_ja: "キャンピングシェルター", w4_en: "Tenta Brella", w4_img: "https://app.splatoon2.nintendo.net/images/weapon/cdb032aa993f4836580ce4edac06de0138833299.png" }, { num: 370, start: 1558677600, end: 1558807200, stage: 1, stage_ja: "シェケナダム", stage_en: "Spawning Grounds", stage_img: "https://app.splatoon2.nintendo.net/images/coop_stage/65c68c6f0641cc5654434b78a6f10b0ad32ccdee.png", w1: "5020", w1_ja: "ケルビン525", w1_en: "Glooga Dualies", w1_img: "https://app.splatoon2.nintendo.net/images/weapon/7d6032f0ceee14c4607385b848c6e486b84a2865.png", w2: "6020", w2_ja: "スパイガジェット", w2_en: "Undercover Brella", w2_img: "https://app.splatoon2.nintendo.net/images/weapon/15fe3fe6bbec24ddb5fdc3ffd06585bc82440531.png", w3: "3000", w3_ja: "バケットスロッシャー", w3_en: "Slosher", w3_img: "https://app.splatoon2.nintendo.net/images/weapon/3963a3fb1ff8038a42072e913587fc6f9aa00d71.png", w4: "4010", w4_ja: "バレルスピナー", w4_en: "Heavy Splatling", w4_img: "https://app.splatoon2.nintendo.net/images/weapon/6f42c9f8fde07510a01072a669125545f6effb99.png" }, { num: 369, start: 1558526400, end: 1558656000, stage: 3, stage_ja: "海上集落シャケト場", stage_en: "Lost Outpost", stage_img: "https://app.splatoon2.nintendo.net/images/coop_stage/6d68f5baa75f3a94e5e9bfb89b82e7377e3ecd2c.png", w1: "5040", w1_ja: "クアッドホッパーブラック", w1_en: "Dark Tetra Dualies", w1_img: "https://app.splatoon2.nintendo.net/images/weapon/ba750d284eb067abdc995435c3358eed4e6f90fa.png", w2: "1100", w2_ja: "パブロ", w2_en: "Inkbrush", w2_img: "https://app.splatoon2.nintendo.net/images/weapon/1f94c29067c918ac9143b756dc607ff0f8cf4e63.png", w3: "50", w3_ja: ".52ガロン", w3_en: "".52 Gal", w3_img: "https://app.splatoon2.nintendo.net/images/weapon/df04ddaf086cea94491df553a6d2550230a4da3c.png", w4: "2020", w4_ja: "スプラスコープ", w4_en: "Splatterscope", w4_img: "https://app.splatoon2.nintendo.net/images/weapon/0ec07bb00918f071975b35191e0860152bdcb321.png" }, ... ]
API①②の値について
num : 第n回サーモンラン
2017/07/21 15:00からのサーモンランを第1回としてカウントしています。
start : 開始時刻
UNIXタイムスタンプ形式
end : 終了時刻
UNIXタイムスタンプ形式
stage : ステージ番号
登場順
stage_ja : ステージ名(日本語)
stage_en : ステージ名(英語)
stage_img : ステージ画像URL
参考:ステージデータ対応表
stage | stage_ja | stage_en | stage_img |
1 | シェケナダム | Spawning Grounds | https://app.splatoon2.nintendo.net/images/coop_stage/65c68c6f0641cc5654434b78a6f10b0ad32ccdee.png |
2 | 難破船ドン・ブラコ | Marooner's Bay | https://app.splatoon2.nintendo.net/images/coop_stage/e07d73b7d9f0c64e552b34a2e6c29b8564c63388.png |
3 | 海上集落シャケト場 | Lost Outpost | https://app.splatoon2.nintendo.net/images/coop_stage/6d68f5baa75f3a94e5e9bfb89b82e7377e3ecd2c.png |
4 | トキシラズいぶし工房 | Salmonid Smokeyard | https://app.splatoon2.nintendo.net/images/coop_stage/e9f7c7b35e6d46778cd3cbc0d89bd7e1bc3be493.png |
5 | 朽ちた箱舟 ポラリス | Ruins of Ark Polaris | https://app.splatoon2.nintendo.net/images/coop_stage/50064ec6e97aac91e70df5fc2cfecf61ad8615fd.png |
w1 : ブキ(内部ID)
イカリング2(SplatNet2)の内部キーの値。"-1"は緑色の「?」、"-2"は金色の「?」
w1_ja : ブキ名(日本語)
w1_en : ブキ名(英語)
w1_img : ブキ画像URL
参考:ブキデータ対応表
w1 | w1_ja | w1_en | w1_img |
-2 | ? | ? | https://app.splatoon2.nintendo.net/images/coop_weapons/7076c8181ab5c49d2ac91e43a2d945a46a99c17d.png |
-1 | ? | ? | https://app.splatoon2.nintendo.net/images/coop_weapons/746f7e90bc151334f0bf0d2a1f0987e311b03736.png |
0 | ボールドマーカー | Sploosh-o-matic | https://app.splatoon2.nintendo.net/images/weapon/32d41a5d14de756c3e5a1ee97a9bd8fcb9e69bf5.png |
10 | わかばシューター | Splattershot Jr. | https://app.splatoon2.nintendo.net/images/weapon/91b6666bcbfccc204d86f21222a8db22a27d08d0.png |
20 | シャープマーカー | Splash-o-matic | https://app.splatoon2.nintendo.net/images/weapon/e5a97d52f12a83a037526588363021f2c1f718b0.png |
30 | プロモデラーMG | Aerospray MG | https://app.splatoon2.nintendo.net/images/weapon/c6ab7ebff7af7f7604eb53a12851da880b1ec2c7.png |
40 | スプラシューター | Splattershot | https://app.splatoon2.nintendo.net/images/weapon/e1d09fc9502a81c82137c8dcd5a872eb872af697.png |
50 | .52ガロン | .52 Gal | https://app.splatoon2.nintendo.net/images/weapon/df04ddaf086cea94491df553a6d2550230a4da3c.png |
60 | N-ZAP85 | N-ZAP '85 | https://app.splatoon2.nintendo.net/images/weapon/1f2b1db5917ef7a4e62f0e15b8805275e33f2179.png |
70 | プライムシューター | Splattershot Pro | https://app.splatoon2.nintendo.net/images/weapon/2e2b59379b8f14cfed0600f84590be0ecad707b6.png |
80 | .96ガロン | .96 Gal | https://app.splatoon2.nintendo.net/images/weapon/df90f6065594378690647c23d42440e2de89c99d.png |
90 | ジェットスイーパー | Jet Squelcher | https://app.splatoon2.nintendo.net/images/weapon/007fb7ed50e76dde495ffb0747421b50dfce8aa3.png |
200 | ノヴァブラスター | Luna Blaster | https://app.splatoon2.nintendo.net/images/weapon/3f840ce3cc5ac0b8cbf7451079b57e807d8b95f1.png |
210 | ホットブラスター | Blaster | https://app.splatoon2.nintendo.net/images/weapon/cfafc8bc42bcd89058fdb22b7b943fb9f893adb8.png |
220 | ロングブラスター | Range Blaster | https://app.splatoon2.nintendo.net/images/weapon/109b2b851481510eaacb50afc8ce9fb79b7f20ad.png |
230 | クラッシュブラスター | Clash Blaster | https://app.splatoon2.nintendo.net/images/weapon/2b684d81508ca5286060767e29dd81ca38303f43.png |
240 | ラピッドブラスター | Rapid Blaster | https://app.splatoon2.nintendo.net/images/weapon/72bdcf5f6077bd7149832153034b3f43d16ac461.png |
250 | Rブラスターエリート | Rapid Blaster Pro | https://app.splatoon2.nintendo.net/images/weapon/8f64580bb033ba86fa0179179cfeb56b5544fda6.png |
300 | L3リールガン | L-3 Nozzlenose | https://app.splatoon2.nintendo.net/images/weapon/202724be5bb5e59457227d087d7c48a32c01db24.png |
310 | H3リールガン | H-3 Nozzlenose | https://app.splatoon2.nintendo.net/images/weapon/45e8847cbaf09bdc86c6e6627236286781b09f0f.png |
400 | ボトルガイザー | Squeezer | https://app.splatoon2.nintendo.net/images/weapon/b9901d49ef3229d3e62d58fc3e1edc8c48da6873.png |
1000 | カーボンローラー | Carbon Roller | https://app.splatoon2.nintendo.net/images/weapon/123db7c37066e10e2c437656db2a26f18898e6b6.png |
1010 | スプラローラー | Splat Roller | https://app.splatoon2.nintendo.net/images/weapon/1041dbdd11b3036671148d47c2e0798cecf3dba2.png |
1020 | ダイナモローラー | Dynamo Roller | https://app.splatoon2.nintendo.net/images/weapon/3d274190988ad20dd1b02825448edbb6e12c720c.png |
1030 | ヴァリアブルローラー | Flingza Roller | https://app.splatoon2.nintendo.net/images/weapon/e32ed68bb18628c5ede5816a2fbc2b8fcdd04124.png |
1100 | パブロ | Inkbrush | https://app.splatoon2.nintendo.net/images/weapon/1f94c29067c918ac9143b756dc607ff0f8cf4e63.png |
1110 | ホクサイ | Octobrush | https://app.splatoon2.nintendo.net/images/weapon/f1d5740dfb7d87f7e43974bbe5585445368741b8.png |
2000 | スクイックリンα | Classic Squiffer | https://app.splatoon2.nintendo.net/images/weapon/5a0a20324f1374a363363d721a605849e36ffff2.png |
2010 | スプラチャージャー | Splat Charger | https://app.splatoon2.nintendo.net/images/weapon/1ed94885bef2b0e498ed4dd76bea9064c85cfc94.png |
2020 | スプラスコープ | Splatterscope | https://app.splatoon2.nintendo.net/images/weapon/0ec07bb00918f071975b35191e0860152bdcb321.png |
2030 | リッター4K | E-liter 4K | https://app.splatoon2.nintendo.net/images/weapon/a6279990ad871fccdd9f2a64a2951f8726f45c48.png |
2040 | 4Kスコープ | E-liter 4K Scope | https://app.splatoon2.nintendo.net/images/weapon/fd4b89e84b375f01290185f2236dbee935dd1682.png |
2050 | 14式竹筒銃・甲 | Bamboozler 14 Mk I | https://app.splatoon2.nintendo.net/images/weapon/6ecbbb897d6c59a5c03097216ef4f803366ea6fa.png |
2060 | ソイチューバー | Goo Tuber | https://app.splatoon2.nintendo.net/images/weapon/26d523e6eee3d57dc6c5f531dfc1747ffd46b8b8.png |
3000 | バケットスロッシャー | Slosher | https://app.splatoon2.nintendo.net/images/weapon/3963a3fb1ff8038a42072e913587fc6f9aa00d71.png |
3010 | ヒッセン | Tri-Slosher | https://app.splatoon2.nintendo.net/images/weapon/ad921a57ab1b7721c50873c082bb34591b61021c.png |
3020 | スクリュースロッシャー | Sloshing Machine | https://app.splatoon2.nintendo.net/images/weapon/27a026e7dec5a068777bb7883f50451aec799d71.png |
3030 | オーバーフロッシャー | Bloblobber | https://app.splatoon2.nintendo.net/images/weapon/2835f6d61a4296b4ac3876337884a0c453a4fa4f.png |
3040 | エクスプロッシャー | Explosher | https://app.splatoon2.nintendo.net/images/weapon/6f1c2a339db6ec0dccb65704adee2db93c768245.png |
4000 | スプラスピナー | Mini Splatling | https://app.splatoon2.nintendo.net/images/weapon/2a1c5ca0e68919b4d655bd860cac3b2942b95498.png |
4010 | バレルスピナー | Heavy Splatling | https://app.splatoon2.nintendo.net/images/weapon/6f42c9f8fde07510a01072a669125545f6effb99.png |
4020 | ハイドラント | Hydra Splatling | https://app.splatoon2.nintendo.net/images/weapon/e34bbd580e49695b97d5fc4464cc901d4fe08ce5.png |
4030 | クーゲルシュライバー | Ballpoint Splatling | https://app.splatoon2.nintendo.net/images/weapon/f208b6222acb5014ab96285e9b9a3e98039c884b.png |
4040 | ノーチラス47 | Nautilus 47 | https://app.splatoon2.nintendo.net/images/weapon/d79b99092aa03dc249b1f767197c1ecbda9d3cd7.png |
5000 | スパッタリー | Dapple Dualies | https://app.splatoon2.nintendo.net/images/weapon/cc4bc30ff53bf2b45bd5e3dadceb39d52b95761f.png |
5010 | スプラマニューバー | Splat Dualies | https://app.splatoon2.nintendo.net/images/weapon/bb5caf24e43f8c7ceb126670bf24fd3aa9a3c3fc.png |
5020 | ケルビン525 | Glooga Dualies | https://app.splatoon2.nintendo.net/images/weapon/7d6032f0ceee14c4607385b848c6e486b84a2865.png |
5030 | デュアルスイーパー | Dualie Squelchers | https://app.splatoon2.nintendo.net/images/weapon/aaead5ff0b63cdcb989b211d649b2552bb3e3a1b.png |
5040 | クアッドホッパーブラック | Dark Tetra Dualies | https://app.splatoon2.nintendo.net/images/weapon/ba750d284eb067abdc995435c3358eed4e6f90fa.png |
6000 | パラシェルター | Splat Brella | https://app.splatoon2.nintendo.net/images/weapon/f1fa6db2e21f32cd1c2cd093ec24f1a450d4650c.png |
6010 | キャンピングシェルター | Tenta Brella | https://app.splatoon2.nintendo.net/images/weapon/cdb032aa993f4836580ce4edac06de0138833299.png |
6020 | スパイガジェット | Undercover Brella | https://app.splatoon2.nintendo.net/images/weapon/15fe3fe6bbec24ddb5fdc3ffd06585bc82440531.png |
おまけデータ:「報酬ギア」
https://splamp.info/salmon/api/reward_gear.json
「今月のギア」として毎月配信されてきた報酬は、2019年8月から「今回のギア」として毎シフト順番に繰り返し登場するようになりました。
このデータでは、2017年7月から2019年7月までの全25個のギア情報をJSON形式でまとめています。
不変データですので、ソースコードから直接利用することが可能です。
「今回のギア」の計算方法
$thを「第n回」、$gearsをこのデータの配列とすると、 $gears[($th - 8) % 25] のような計算式で求めることができます。
サンプルコード
Crieitで、サーモンランAPIを使ってできることを連載しています。
このAPIを使ったアプリ
-
Salmon Learn - サーモンラーン
「シフト」の表示に使って頂いています。
更新履歴
2019/08/01 おまけデータ:「報酬ギア」 を追加しました。
2019/07/08 マルチバイト文字をエスケープせずそのまま返却するようになりました。CORS設定を追加し、JavaScriptから利用できるようになりました。
2019/05/28 公開