跳到主要内容

功能说明​

待登录端获取二维码,交由已登录端 扫码确认,待登录端通过 检查扫码状态 领取登录结果。

请求说明​

请求鉴权:免登录,仅需 appkey,无需 Authorization。

请求类型:GET

请求限频:100次/秒

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

Content-Type:application/json

请求参数​

无请求体,也不在获取阶段提交设备字段。

请求示例​

GET /jim/login/qrcode HTTP/1.1
appkey: appkey
Content-Type: application/json

响应示例​

{
"code":0,
"msg":"success",
"data":{
"id":"<二维码ID>",
"poll_secret":"<轮询秘密>",
"qr_code":"<PNG图片的Base64>"
}
}

三个响应字段均为 string。qr_code 是 400×400 PNG 的裸 Base64,不含 data URL 前缀;需要时加 data:image/png;base64, 展示。二维码内实际 JSON 为:

{"action":"login","code":"<二维码ID>"}

二维码中的 code 对应 check/confirm 的 id,不包含 poll_secret。秘密仅留在待登录端,不放入二维码、分享链接、埋点或日志。二维码从服务端创建起十分钟有效,响应没有 expires_at,倒计时仅作提示,以服务端结果为准。设备/存储失败可能返回 17600,错误结构见 设备登录规则。