跳到主要内容

功能说明​

已登录端解析二维码 {"action":"login","code":"<二维码ID>"} 后,经用户确认允许待登录端登录。二维码中的 code 作为本请求的 id。

请求说明​

请求鉴权:需要 appkey 和用户 Authorization 原文,不加 Bearer 。新用户设备会话可确认;兼容期旧用户 token 也可确认,严格截止后旧 token 被拒绝。API Key 和内部服务凭证不允许。

请求类型:POST

请求限频:100次/秒

请求地址:https://请求域名/jim/login/qrcode/confirm

Content-Type:application/json

请求参数​

参数数据类型是否必填参数说明
idstring是扫码得到的二维码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。详见 错误结构。