Splatoon 2 API 完全参考手册NintendoSwitchRESTAPI 覆盖 14 个端点的全量调用指南【免费下载链接】NintendoSwitchRESTAPIReverse engineered REST API used in the Nintendo Switch app for iOS. Includes documentation on Splatoon 2s API.项目地址: https://gitcode.com/gh_mirrors/ni/NintendoSwitchRESTAPISplatoon 2 API 是《斯普拉遁 2》Splatoon 2内置网页应用背后的整套 REST 接口。开源项目 NintendoSwitchRESTAPI 通过逆向工程将这套 Splatoon 2 API 文档完整整理出来覆盖 14 个端点从对战战绩、单人模式、地图排程到祭典排行、在线商店一应俱全。本文面向新手和普通开发者用最直白的方式带你认识这 14 个端点的用途、调用顺序与关键字段是一份可以直接上手的 Splatoon 2 API 参考手册。什么是 NintendoSwitchRESTAPINintendoSwitchRESTAPI 是一个逆向工程开源项目作者在 iPhone 7iOS 10.3.3上安装 Nintendo Switch App 1.0.4 版本借助 mitmproxy 抓包工具把 App 与服务器之间的所有请求、响应、认证流程全部记录下来整理成一套结构化的 REST API 文档。由于该 App 完全没有做证书固定cert-pinning抓包过程非常顺利。项目文档由四部分组成readme.md总体介绍与 8 步认证流程说明NintendoAccountBlueprint.mdNintendo Account 账号体系接口登录、令牌SwitchBlueprint.mdNintendo Switch App 本体接口账号登录、游戏列表、Web 服务令牌Splatoon2Blueprint.md核心的 Splatoon 2 API 文档即本文的主角共 14 个端点Splatoon 2.paw面向 macOS 用户的 Paw 调试工程填好环境变量即可直接调试接口 想本地查阅完整文档可以克隆仓库git clone https://gitcode.com/gh_mirrors/ni/NintendoSwitchRESTAPI调用 Splatoon 2 API 前需要准备什么在动手调用之前先备齐下面几样东西可以少走很多弯路一个任天堂账号Splatoon 2 API 的鉴权完全依托 Nintendo Account账号是硬前提。一份可用的访问凭证最终通过 8 步认证流程换取一个iksm_sessionCookie所有接口都靠它。推荐设置 User-Agent文档建议所有 Splatoon 2 API 请求统一使用Mozilla/5.0 (iPhone; CPU iPhone OS 10_3_3 like Mac OS X) AppleWebKit/603.3.8 (KHTML, like Gecko) Mobile/14G60服务器目前不校验但低调总没错。可选Paw 工具macOS 用户可以直接打开 Splatoon 2.paw 工程填入 Client ID、Login Page Token Code 等环境变量按顺序执行即可完成鉴权。Splatoon 2 API 鉴权流程8 步拿到访问凭证Splatoon 2 API 的鉴权链路较长但思路清晰可以概括为账号令牌 → 游戏令牌 → 会话 Cookie三个阶段步骤动作说明1浏览器访问授权链接登录 Nintendo Account从重定向 URL 中提取session_token_code与state2换取 session tokenPOST /connect/1.0.0/api/session_token3换取 service tokenPOST /connect/1.0.0/api/token用上一步的session_token4登录 Switch 账号POST /v1/Account/Login需要id_token及f参数5获取游戏列表POST /v1/Game/ListWebServices用webApiServerCredential中的 accessToken6获取 Splatoon 游戏令牌POST /v1/Game/GetWebServiceToken拿到 Splatoon 2 专属accessToken7获取会话 CookieGET /首页携带X-GameWebToken请求头从Set-Cookie中取iksm_session8开始调用 14 个端点之后的每个请求都带上步骤 7 拿到的 Cookie其中最容易卡住的是第 4 步的f参数它由 App 客户端生成目前只能通过 mitmproxy 从真机抓取具体可参考 SwitchBlueprint.md 中的说明。Splatoon 2 API 14 个端点全览拿到 Cookie 之后Splatoon 2 的全部 14 个端点即可按需调用先看总表端点方法功能/GET首页换取会话 Cookie/api/resultsGET最近 50 场对战记录/api/results/{battle_number}GET单场对战详情/api/records/heroGET单人模式英雄模式通关数据/api/schedulesGET各模式的地图排程/api/data/stagesGET全部地图舞台数据/api/timelineGET时间线活动安排/api/nickname_and_iconGET玩家昵称与头像支持按 id 查询/api/festivals/activeGET当前进行中的祭典/api/festivals/{festival_id}/votesGET祭典投票数据/api/festivals/pastsGET往期祭典列表/api/festivals/{id}/rankingsGET祭典排行/api/onlineshop/merchandisesGET在线商店在售装备列表/api/onlineshop/order/{item_id}POST下单购买指定装备这些端点的完整请求/响应示例含大量 JSON 样例都在 Splatoon2Blueprint.md 中按目录跳转即可对照查阅。按功能分类详解端点对战战绩查询接口对战数据是 Splatoon 2 API 使用频率最高的一类GET /api/results返回最近 50 场比赛每条记录包含胜负my_team_result、模式game_mode如 regular / gachi、规则rule如涂地、占地对战、地图、武器、玩家段位udemae等响应末尾还附有summary汇总胜率、平均击杀等。GET /api/results/{battle_number}用结果列表里的battle_number字段查询单场对战的完整详情包括双方全部玩家的装备、技能主技能 副技能、击杀/助攻/阵亡数据。单人模式记录接口GET /api/records/hero返回英雄模式单人战役的关卡通关进度包括stage_infos中各关卡的通关时间、武器、Boss 关卡标记以及总通关率等summary数据。排程与地图数据接口GET /api/schedules返回当前与未来的模式排程覆盖普通对战、真格、联赛等每条排程给出起止时间、规则以及两张地图stage_a/stage_b。想做换图提醒或排程日历工具这个接口是核心数据源。GET /api/data/stages返回全部地图的静态数据id、名称、图片地址适合用于本地建索引。时间线与玩家资料接口GET /api/timeline返回活动时间线可了解当前开放的模式与活动安排。GET /api/nickname_and_icon查询玩家昵称与头像支持传入id参数查询指定玩家适合做对战记录中的玩家信息展示。祭典数据接口4 个祭典Splatfest是 Splatoon 2 的招牌活动API 专门提供了 4 个端点GET /api/festivals/active当前进行中的祭典信息GET /api/festivals/{festival_id}/votes指定祭典的投票分布数据GET /api/festivals/pasts往期祭典回顾GET /api/festivals/{id}/rankings祭典期间的个人/队伍排行在线商店与下单接口GET /api/onlineshop/merchandises在线商店当前在售的全部装备头饰、衣服、鞋子包含价格、稀有度、品牌与附加技能。POST /api/onlineshop/order/{item_id}对指定商品下单购买是所有端点中唯一的写操作可用于开发每日限购提醒类工具。响应数据结构速览Splatoon 2 API 返回的 JSON 结构层级清晰几个高频字段值得先熟悉battle_number对战编号单场详情查询的入参udemae玩家段位含name如 B、B与numbergame_mode/rule模式与规则均含key代码与name显示名stage地图对象含 id、名称与图片weapon武器对象含主武器、副武器sub与特殊武器specialplayer_result本人战绩含击杀、助攻、阵亡、涂地面积my_team_result/other_team_result胜负结果victory / defeat常见问题 FAQ问第 4 步的f参数怎么生成答目前官方 App 之外的途径暂时无法生成最稳妥的方式是手机装好 Switch App用 mitmproxy 抓取一次登录请求从请求体中提取f参数后缓存复用。问一定要用美区账号、英文语言吗答文档是基于美区 英文环境测试的其他地区可能存在细微差异但整体接口结构一致。问调用频率有限制吗答文档未提及限流但建议请求带上推荐的 User-Agent并控制合理的调用节奏避免给服务器造成压力。结语NintendoSwitchRESTAPI 这份开源文档把 Splatoon 2 API 的 14 个端点、认证链路和数据结构完整还原是研究任天堂 App 接口或开发 Splatoon 2 数据工具的绝佳起点。无论是想拉取自己的对战战绩、监控地图排程还是做祭典排行分析照着本文的顺序一步步来都能快速跑通。更多细节每个端点的完整 JSON 示例可直接查阅项目内的 Splatoon2Blueprint.md 与 Splatoon 2.paw 工程。【免费下载链接】NintendoSwitchRESTAPIReverse engineered REST API used in the Nintendo Switch app for iOS. Includes documentation on Splatoon 2s API.项目地址: https://gitcode.com/gh_mirrors/ni/NintendoSwitchRESTAPI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考