调用前需要哪些信息?
准备有效 APIKey 和控制台中的 appid,并按具体接口核对必填字段与附加约束。查看接入流程。
扫码、验证码、重连与退出,完成账号接入。 本页列出此分组全部 6 个 POST 接口。
创建一个设备,返回的标识用于后续扫码登录。⚠️ version 是整数,传 0 即可;传版本号字符串会被拒绝。
/qingluan/api/device/create获取登录二维码。返回的 data.uuid 用于后续「查询扫码状态」。
/qingluan/api/login/getQr轮询扫码状态。status:-1 未扫码 · 0 可免扫码 · 1 已扫待确认 · 2 登录成功 · 4 用户取消 · 10 待输入验证码。⚠️ -1 是尚未扫码,不是二维码失效。
/qingluan/api/login/checkQr扫码后若返回 status=10 才需要调用。无需验证码时返回 -12019 qrcode_not_need_verify。
/qingluan/api/login/submitQrCode断线重连。
/qingluan/api/login/reconnect退出登录。
/qingluan/api/login/logout准备有效 APIKey 和控制台中的 appid,并按具体接口核对必填字段与附加约束。查看接入流程。
本组数据面接口返回能力层原始响应。code = 0 表示请求被接受,实际效果及状态应结合接口说明与查询结果确认。