appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"断线重连。
/qingluan/api/login/reconnect断线重连。
⚠️ 返回码不代表连接已恢复:本接口可能返回 code = 0,而长连接仍处于断开状态且不会自行恢复,需要重新扫码登录。判断账号是否可用请调用任一业务读接口,不要依据本接口的返回码。
请求体必填。通过 QL-Key 请求头携带 APIKey。
Content-Type:application/json
请求参数。字段名区分大小写,请按文档原样传递。
appidstring必填青鸾实例 ID,形如 we_xxxxxxxxxxxxxxx。在开发者控制台「实例与回调」扫码上号后获得。
"we_xxxxxxxxxxxxxxx"proxystring必填代理地址
代理地址,不用则传空串
注意:契约内部矛盾:required 里有它,但 example 里没有。不用代理时是必须传空串还是可省略未确认;建议按必填传 "",与同组 getQr/checkQr 的 example 写法一致。
""本接口为能力层原样返回,不统一增加青鸾外层信封。code = 0 仅表示请求被接受,不保证副作用已完成。
本接口返回码不能证明长连接已恢复;请按接口说明调用业务读接口确认账号是否可用。
能力层原样返回;code = 0 仅表示请求已受理,业务结果须按接口说明确认。
application/json
接口原样返回平台的业务响应。HTTP 状态码与业务状态码需分别判断:HTTP 200 只表示请求已送达,成功以 code = 0 为准。
codeinteger必填业务状态码
业务状态码:0 表示成功,-1 表示失败;失败原因见 message。
0dataobject可选业务数据
接口无固定结构化返回数据;成功时通常为空对象或省略 data。
detailstring可选错误详情
错误详情;无补充信息时通常为空字符串。
messagestring必填响应消息
业务结果消息。成功通常为 ok;企微错误通常为 错误码|错误信息。
"ok"timestring必填服务端时间
服务端时间,格式为 YYYY-MM-DD HH:mm:ss。
"2026-07-21 07:33:17"受控接口,需通过控制台配置
appid 不存在或无权访问