接口文档

使用协议

1. 禁止发送涉黄、涉政、涉恐、辱骂、威胁、广告、诈骗等违规内容。后台已接入云文字识别，检测到违规内容后可能封禁账户，识别结果可能存在误伤。如果涉及法律责任，相关内容将被上报至有关部门。
2. 使用本站服务，即默认同意本网站平台机器人账号有权通过平台 API 功能，被动向您推送消息。
3. 使用本站服务，即默认同意本网站保留对您在本网站账号的全部管理权利。
4. 平台不会主动向您推送消息。您在平台上的一切活动均为主观操作，与平台无关。

快速开始

使用 QQ 登录后，在控制台获取 API Key，并添加机器人为好友。API Key 是推送凭证，请勿泄露或提交到公共代码仓库。

统一约定

成功响应

{
  "success": true,
  "message": "操作成功"
  "code": 0,
  "data": 42
}

推送接口中的 data 是消息 ID，可用于查询消息状态。

失败响应

{
  "success": false,
  "message": "错误描述"
  "code": 500,
  "data": null
}

响应结果中的 code 目前只有0和500，0代表成功，500是有错误，请使用success属性来判断本次业务是否成功。

使用查询参数或表单参数提交目标 QQ 和消息内容。

GET 示例

https://qmsg.zendee.cn/v3/send/你的Key?qq=12345678&msg=服务器任务完成

POST 示例

curl -X POST "https://qmsg.zendee.cn/v3/send/你的Key" \
  -d "qq=12345678" \
  --data-urlencode "msg=服务器任务完成"

请求头必须包含 Content-Type: application/json。

请求体

{
  "qq": "12345678",
  "msg": "服务器任务完成"
}

请求示例

curl -X POST "https://qmsg.zendee.cn/v3/jsend/你的Key" \
  -H "Content-Type: application/json" \
  -d '{"qq":"12345678","msg":"服务器任务完成"}'

根据发送接口返回的消息 ID 查询状态。

请求示例

https://qmsg.zendee.cn/v3/msg/status/你的Key?msgId=42

响应示例

{
  "success": true,
  "message": "操作成功"
  "code": 0,
  "data": 1
}