nearcade API 接入指南

欢迎各位 bot 开发者采用 nearcade 数据源！ nearcade API 目前可以提供店铺搜索、店铺详情、在勤人数查询、在勤人数上报功能。 API 文档：https://nearcade.apifox.cn/ 注意事项 1. 在使用在勤人数上报接口前，需要先绑定手机号并添加至少一个 API 令牌； 2. 请合理使用在勤人数上报接口，维护数据人人有责。 上报在勤人数 在该工作流中，建议首先在客户端录入店铺与游戏数据，设置店铺别名、默认游戏、游戏别名，然后再使用在勤人数上报接口上传数据。 以下是个人推荐的工作流最佳实践： 1. 实现店铺搜索指令，使用店铺搜索接口根据指定关键词搜索店铺，并将带序号的结果展示给用户； 2. 实现店铺添加指令，将用户通过序号或完整名称指定的店铺添加至客户端所管理的群组中，并默认将 gameId 最小的游戏（版本）作为店铺默认游戏； - 指令额外接受数个别名参数并设置为店铺的初始别名列表； - 在获取到店铺详情后，至少需要在客户端保存店铺名称与游戏（版本）列表（每项至少保存 gameId 与 titleId），以避免频繁访问相关接口； 3. 实现店铺获取、删除指令，其中获取指令返回的数据可结合客户端记录的店铺别名列表、游戏别名列表以及通过店铺详情接口获取的数据； 4. 实现店铺别名添加、修改、删除指令； 5. 实现店铺游戏别名添加、修改、删除指令； 6. 实现在勤人数查询指令，首先根据店铺别名匹配指定店铺，然后使用在勤人数获取接口获取并展示数据； 7. 实现在勤人数上报指令，首先根据店铺别名匹配指定店铺，再根据游戏别名或默认游戏匹配指定游戏（版本），最后使用在勤人数上报接口上传指定的人数数据； - 访问在勤人数上报接口时，需要将先前准备好的 API 令牌放入请求的 Authorization header 中，值为 Bearer {你的 API 令牌}。 FAQ 待补充

Comments (1)

Delete Comment

Delete Post