③ 查询扫码登录状态

POST

https://console.wecomapi.com/wecom/finder/api

接口提示

获取登录二维码后轮询本接口，建议间隔 2–3 秒，查询直至登录成功或失败；二维码超时后重新获取。

loginQrcodeStatus=2 表示登录成功；10 表示需要调用校验登录验证码，校验后继续查询本接口。

登录状态：-1 表示登录失效、需要重新扫码；0 表示未登录，可免扫码登录；1 表示已扫码、待确认；2 表示登录成功；3 表示登录失败；4 表示用户取消登录；10 表示已扫码确认、需要提交 6 位验证码。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://console.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/login/checkLoginQrCode",
  "params": {
    "guid": ""
  }
}'

响应示例

{
  "code": 0,
  "data": {
    "avatarUrl": "",
    "corpId": "",
    "corpLogo": "",
    "loginQrcodeKey": "",
    "loginQrcodeStatus": 1,
    "nickname": "",
    "userId": "168885*****"
  },
  "msg": "成功"
}

④ 校验登录验证码（按需）

免扫码二次登录