创建设备（步骤1）

POST

/api/qw/doApi

📱 创建设备 — 获取虚拟设备实例

通过该接口创建一个企业微信云设备实例，返回 guid（设备唯一标识）。后续所有操作（扫码登录、收发消息等）均依赖此 guid。

⚠️ 重要：创建/恢复设备后 5 分钟内未完成登录，该实例将自动清理。代理地区务必与企微手机登录所在地一致，严禁异省，否则可能导致登录失败。

登录流程图

检测状态根据 loginQrcodeStatus返回的

登录步骤

掉线后恢复登录

✅ 设备创建成功！请保存返回的 guid，随后调用「二维码-获取」接口进行扫码登录。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.qiweapi.com/qiwe/api/qw/doApi' \
--header 'X-QIWEI-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/client/createClient",
  "params": {
    "proxyUrl": "",
    "areaCode": 320000,
    "deviceName": "stone的ipad",
    "deviceType": 0,
    "clientVersion": "" 
  }
}'

响应示例

{
    "code": 0,
    "data": {
        "guid": "string"
    },
    "msg": "string"
}

修改于 2026-06-13 09:39:25

常见问题

二维码-获取（步骤2）

创建设备（步骤1）

📱 创建设备 — 获取虚拟设备实例#

请求参数

返回响应

📱 创建设备 — 获取虚拟设备实例