功能说明
待登录端获取二维码,交由已登录端 扫码确认,待登录端通过 检查扫码状态 领取登录结果。
请求说明
请求鉴权:免登录,仅需
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,错误结构见 设备登录规则。