刷新设备

当登录流程提示需要手机输入 iPad 验证码时，用本接口刷新设备并获取扫码地址。

接口地址： POST /refreshDevice

注意

本接口只在登录过程中出现设备验证、iPad 验证码等场景时使用；普通登录流程无需调用。

前置条件

• 已调用获取登录二维码接口，并拿到返回的 wId。
• 第三步执行登录接口提示需要刷新设备或输入验证码。
• 用户需要根据返回的二维码地址完成手机端扫码或验证动作。

请求参数

参数名	必选	类型	说明
wId	是	string	获取登录二维码时返回的登录实例标识

请求示例

{
  "wId": "6a696578-16ea-4edc-ac8b-e609bca39c69"
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	刷新设备结果
data.wId	string	登录实例标识
data.qrCodeUrl	string	扫码验证地址

成功响应

{
  "code": "1000",
  "message": "登录成功",
  "data": {
    "wId": "0000016e-63ef-3a9c-0001-ed3311628ef4",
    "qrCodeUrl": "http://127.0.0.1:18081/1573634652963-500000.png"
  }
}

错误响应

{
  "code": "1001",
  "message": "刷新设备失败",
  "data": null
}

使用建议

• 推荐流程：执行登录接口提示需要验证后，调用本接口取码，用户扫码或完成验证，再重新调用执行登录接口。
• 重新调用执行登录接口时，按登录接口提示处理验证码参数；如果提示无需验证码，则不要额外传验证码。
• qrCodeUrl 可能有时效，过期后需要重新刷新设备。