接口文档

使用协议

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

快速开始

使用 QQ 登录后，在控制台获取 API Key，然后使用 QQ 扫码添加机器人为好友，并向机器人发送您的 API Key 完成绑定。绑定完成后，推送的消息将由该机器人发送到您的 QQ 单聊。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 单聊；传入 group 参数则推送到对应的 QQ 群。

GET 示例

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

POST 示例

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

群推送示例

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

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

请求体

{
  "msg": "服务器任务完成"
}

可选字段 group 为目标 QQ 群号，传入后消息将推送到该群（需先在控制台添加该群并完成群绑定）。

请求示例

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

群推送示例

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

推送为异步处理，返回消息 ID 后即可通过状态接口查询发送结果。

请求示例

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

响应示例

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