当前公开契约 · 消息

企业微信查询待发群发 API

获取待发送的群发任务列表。返回的 list[].id 供 groupSendPending 使用。 :::tip 🔗 调用关系获取待发送列表 → 读取任务 id → 调用 groupSendPending。 ::: :::check ✅ 成功判定：HTTP 200 且响应体 code = 0。业务失败请查看 message 与 detail。 :::

进入控制台试用查看完整契约

POST实例字段：appid更新：2026-10-11

请求地址

POST https://api.qingluanbot.com/qingluan/api/message/getPendingGroupSendList

请求示例

curl -X POST 'https://api.qingluanbot.com/qingluan/api/message/getPendingGroupSendList' \
  -H 'QL-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "appid": "we_xxxxxxxxxxxxxxx"
}'

请求参数

字段	类型	要求	说明
`appid`	string	必填	青鸾实例 ID，形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。

响应判断

能力层接口返回包含 code、message、time 与 data 等字段；请以 code=0 判断业务成功。HTTP 200 只表示网关已返回响应，不能替代业务状态判断。

可能的响应状态

HTTP 状态	公开契约说明
`200`	原样返回（code = 0 即成功）
`403`	受控接口，需通过控制台配置
`404`	appid 不存在或无权访问

200 响应示例

{
  "code": 0,
  "data": {
    "hasMore": true,
    "list": null,
    "nextKey": {
      "msgId": 0
    }
  }
}

接入步骤

在青鸾开发者控制台创建或查看 API Key。
在「实例与回调」接入企业微信账号，取得 appid。
请求头携带 QL-Key，按当前契约提交 JSON 请求。
读取响应中的 code；仅当 code=0 时按成功流程处理。

把企业微信能力接入你的系统

从 API Key、appid 到首个 code=0 响应，可在开发者控制台完成配置与验证。

打开开发者控制台