/Apex_Stat_for_Hoshino

补充了排位图轮换

Primary LanguagePython

APEX Legends制造器,地图轮换查询

插件还未完成所有功能, 希望有兴趣的dalao提交pr.

此外由于API开发者未提供制造器内物品的所有名字, crafting_names.py内的名字可能还存在不与API匹配的情况, 列表中获取不到对应键值后会显示英文, 之后发现不一致后会随时更新

要获得完整功能, 需要去 APEX LEGENDS STATUS 申请api

更新记录

  • 2022.6.27 更新: crafting_names.py 添加小帮手和CAR的api命名
  • 2022.6.26 修复原料厂地图表达方式不一致导致的错误, 添加了无法寻找到地图时的逻辑, 找不到中文对应的时候显示api返回的英文
  • 2022.6.17 BUG: 解决API服务器返回不存在的图片地址的问题, 图片无法找到的时候使用默认的图标生成图片
  • 2022.6.17 解决origin用户名有空格的问题, 将查询用户信息的搜索格式由origin用户名 平台(PC/PS4/X1)改为[平台(PC/PS4/X1)] origin用户名, 平台可省略, 省略则默认以PC查询.
  • 2022.6.16 添加了用户数据查询的图片化, 暂时只加入了排位数据(每个角色第一次查询的时候会比较慢,因为会去服务器下载图片, 往后就快了)
  • 2022.6.14 因为发送大段文字可能会被风控, 所以紧急添加了图片模式的制造器查询, 简单测试后是可以正常使用了, 但是不排除Bug的可能性 (没用过Pillow感觉代码hardcode写的好傻), api.py 内可以关闭图片模式, True 改成 False 就行了
  • 2022.6.13 添加了查询猎杀分数线和查询用户数据功能, API中的部分数据还未用上, 这些数据其实是可以变成图片加载的.
  • 2022.6.12 添加地图轮换, 制造器查询

部署

  1. 下载或者clone本插件到hoshino\modules目录下
git clone https://github.com/GaryDu0123/Apex_Stat_for_Hoshino
  1. 将申请到的APIkey填写到api.py文件内的API_KEY变量中, 或者不填写

填写示范 API_KEY = "你的APIkey"

  1. 在hoshino\config\bot.py的MODULES_ON中添加 "Apex_Stat_for_Hoshino"
  2. 重启Hoshino Bot

API申请以及使用

基本

在浏览器中打开APEX LEGENDS STATUS(https://apexlegendsapi.com), 看向Create an API key(创建一个API Key), 选择Non-Commercial(非商用), 描述一下使用原因(用于apex数据查询 For apex data query), 尽量使用英文, 开发者好像没有审核描述信息, I agree with API usage rules打钩, 然后点击Create my API key就可以了

注意, 该API注明了商用限制, 若BOT为商用则需要选择Commercial, 请仔细阅读该API提供者发布的使用文档.

这时候页面会跳转, 你将会从页面看到如下信息 You are currently logged in with API key [此处是你的APIkey]. You can access the other pages.

复制这个APIkey到api.py文件内的API_KEY变量中, 便可以正常使用了

进阶

When first creating an API key, you are limited to one request per 2 seconds. This limit can be increased to 2 requests/seconds by connecting with your Discord account. To do so, click on the red popup at the top of the API Portal.

From https://apexlegendsapi.com/#rate-limiting

对于新创建的APIkey, 会被限制为2秒钟才能请求一次, 该限制可以通过绑定Discord账号来提升到1秒请求2次. 具体详细请根据页面提示绑定你的账号从而解除限制.

使用区别

不去申请APIkey也可以使用, 但是使用的命令会有限制. 参考了Apex-Stats-Bot的代码, 使用了fn.alphaleagues.com/v2/apex/map/网站作为了API来源, 但是该网站提供的数据有限, 并且请求参数尚不清楚, 所以只实现了小部分功能.

功能使用方法

@bot apex 查询当前地图
bot名字 apex 查询轮换地图 3

填写APIKEY后的可用指令

指令 描述
apex 查询当前地图 查询当前为哪张地图
apex 查询下张地图 查询下张地图
apex 查询轮换地图 [1-5] 查询未来1-5小时的地图以及轮换时间
apex 查询制造器 查询今日复制器可制造物品
apex 查询猎杀分数线 查询成为猎杀的最低分数
apex 查询用户数据 (平台[PC/PS4/X1]) (origin用户名) 查询用户等级, 排位分数等数据

未填写APIKEY的可用指令

指令 描述
apex 查询当前地图 查询当前为哪张地图
apex 查询轮换地图 [1-5] 查询未来1-5小时的地图以及轮换时间

待实现

  1. 玩家个人数据查询
  2. APEX新闻
  3. 查询数据图片化 (未怎么接触图片处理, 优先度暂时较低)

附录

APEX LEGENDS STATUS API 接口文档

https://apexlegendsapi.com/#introduction