二维码-获取（步骤2）

POST

/work-weixin/api/doApi

提示：登录模块为必要步骤。如需简化流程，可跳过步骤 1-4，直接通过控制台在线登录获取设备 id（guid）后，再进行接口调用。

创建设备成功后，通过此接口获取登录凭证
• 首次登录：请使用参数 useCache=false，获取全新二维码。
• 旧设备异常：提示设备不存在/不在线时，先调用恢复设备接口，再获取二维码。
• 恢复设备后：请使用参数 useCache=true，获取缓存二维码。

请求参数

Header 参数

Body 参数application/json必填

示例

{
   "method": "/login/getLoginQrcode",
   "params": {
      "guid": "6f2752cf-e611-4ba6-ba76-8db0bd555ee4",
      "useCache": true
}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/work-weixin/api/doApi' \
--header 'X-QIWEI-TOKEN;' \
--header 'Content-Type: application/json' \
--data '{
   "method": "/login/getLoginQrcode",
   "params": {
      "guid": "6f2752cf-e611-4ba6-ba76-8db0bd555ee4",
      "useCache": true
}
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "loginQrcodeBase64Data": "string",
        "loginQrcodeKey": "string"
    },
    "msg": "string"
}

修改于 2026-06-01 11:30:28

创建设备（步骤1）

二维码状态-检测（步骤3）