鱼子酱心跳系统

欢迎使用鱼子酱的心跳系统

这套系统有什么功能

• 心跳机制是定时发送一个自定义的结构体(心跳包)，让对方知道自己还活着，以确保连接的有效性的机制。

• 当接入该心跳系统时，会有专门的机器人对上线和离线的客户端进行播报，达到及时发现bot意外离线的目的。

你需要了解的信息

• 你需要明确知晓，心跳上报相关的消息由用户插件本体主动进行上报，仅心跳相关扩展服务而言，服务器不会发出影响到机器人运行的消息，或控制机器人的运行。

• 你需要明确知晓，接入本处所提供的服务器后，你将会出现在一系列的HttpApi之中，例如鱼子酱心跳API之中，这是立即自动完成的，鱼仙不会对因你的相关信息公开而对你造成的任何损失负责，如有隐私方面的顾虑，请在此止步。

• 你需要明晰本处所收集的相关信息，并且明白相关信息被上报之后的意义。

API

GET http://api.fishroud.xyz/heartbeat/

请求

字段名	必须	说明
qq	true	上报心跳机器人的qq号
token	false	上报心跳机器人的token，带上token访问上报心跳，若不带token则返回该bot在线状态

你需要这样接入

• 访问网站青果DICETOKEN获取，挑一个喜欢的token并牢记

• 当你选定了一个Token之后，你需要将它记录下来，将Token与你的所需要接入的bot的QQ号,bot的昵称,你的qq号,你自己的称呼上报给鱼仙

• 得到鱼仙肯定的答复后，使用铃心自定义或其他方法访问上报接口

特别篇：如何使用铃心自定义进行上报

1.开启监控事件

• 打开铃心自定义，选择回复调试

• 在框内输入开启监控事件，点击点我调试

2.填入监控事件相关条件

输入框	填入值	说明
事件名称		可自定义该事件名称
监控周期（min）	1	bot进行上报的频率
条件1	【判空【机器人CsrfToken】>=<0】	取机器人的CsrfToken，若失败则返回0
条件2	0	-
结果	【超级访问-GET-UTFhttp://api.fishroud.xyz/heartbeat/?qq=【机器人QQ】&token=[你上报给鱼仙的token]】	对接口进行上报

• 正确示例：【超级访问-GET-UTFhttp://api.fishroud.xyz/heartbeat/?qq=123456&token=abcdef】

3.完善剩余信息

• 请选择当“条件1”不等于“条件2”时，将结果发送到一个不存在的群号（如123）

• 最后请记得保存

示例图片

4.当群内出现上线提示，则为上报成功