二维码-获取（步骤2）

POST

/api/qw/doApi

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

创建设备成功后，通过此接口获取登录凭证

•

首次登录：请使用参数 useCache=false，获取全新二维码。

•

旧设备异常：提示设备不存在/不在线时，先调用恢复设备接口，再获取二维码。

•

恢复设备后：请使用参数 useCache=true，获取缓存二维码。

请求参数

Header 参数

Body 参数application/json

示例

{
    "method": "/login/getLoginQrcode",
    "params": {
        "guid": "{{guid}}",
        "useCache": true
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://manager.qiweapi.com/qiwe/api/qw/doApi' \
--header 'X-QIWEI-TOKEN: ' \
--header 'X-QIWEI-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
    "method": "/login/getLoginQrcode",
    "params": {
        "guid": "",
        "useCache": true
    }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "loginQrcodeBase64Data": "/9jqo8Zbik......UUUUV//Z",
        "loginQrcodeKey": "FFFFDDDDDFFFFFF"
    },
    "msg": "成功"
}

修改于 2026-05-06 05:47:34

创建设备（步骤1）

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