发送接口文档
1. 请求地址
POST /api/send,请求头 Content-Type: application/json,Body 为 JSON
2. 机器人ID对照表
ID 在添加机器人时自动分配(01、02、03…);bot_id 填这个 ID 即可指定由哪个机器人发出消息。
3. 请求参数(JSON Body)
| 参数 | 类型 | 必填 | 说明 |
| msgtype | string | 是 | 消息类型:text / markdown / image / news |
| bot_id | string | 否 | 目标机器人ID,如 "01";多个用逗号分隔 "01,02";留空发给全部机器人 |
| header | string | 建议填写 | 头部名称,收到的消息显示为【header】内容;留空则不加前缀 |
| content | string | text/markdown 必填 | 文本或 Markdown 内容 |
| news_title | string | news 必填 | 图文卡片标题,实际显示为【头部名称】标题 |
| news_desc | string | 否 | 图文卡片摘要描述 |
| news_url | string | 否 | 点击卡片跳转的链接 |
| news_picurl | string | 否 | 卡片封面图 URL |
| image_b64 | string | image 必填 | 图片 base64(不带 data: 前缀),jpg/png ≤ 2MB |
4. 请求示例
5. 返回示例
{
"ok": 1,
"total": 1,
"results": [
{ "bot": "测试群", "id": "01", "response": { "errcode": 0, "errmsg": "ok" } }
]
}
errcode = 0 表示该机器人发送成功;results 里每个目标机器人独立一条结果。