功能说明
已登录端解析二维码 {"action":"login","code":"<二维码ID>"} 后,经用户确认允许待登录端登录。二维码中的 code 作为本请求的 id。
请求说明
请求鉴权:需要
appkey和用户Authorization原文,不加Bearer。新用户设备会话可确认;兼容期旧用户 token 也可确认,严格截止后旧 token 被拒绝。API Key 和内部服务凭证不允许。
请求类型:
POST
请求限频:
100次/秒
请求地址:https://请求域名/jim/login/qrcode/confirm
Content-Type:
application/json
请求参数
| 参数 | 数据类型 | 是否必填 | 参数说明 | |
|---|---|---|---|---|
| id | string | 是 | 扫码得到的二维码id |
用户身份取自凭证,不接受 body 指定其他用户。不需要 poll_secret,也不代传待登录端的设备身份。
请求示例
POST /jim/login/qrcode/confirm HTTP/1.1
appkey: appkey
Authorization: <用户登录返回的业务凭证原文>
Content-Type: application/json
{
"id":"<二维码ID>"
}
响应示例
{
"code":0,
"msg":"success",
"data":null
}
确认成功不等于待登录端已领取;待登录端仍需调用 check。有效期内同一用户重复确认可成功,不同用户抢占、记录无效/过期及存储状态错误当前由 ConfirmQR 统一映射为通用 17000,通常 {"code":17000,"msg":""},不是 check 的 17007/17608。JSON/id 非法为 17003;缺少/旧凭证被策略拒绝通常 17005,设备会话失效或凭证类型不允许通常 17604。详见 错误结构。