创建设备（步骤1）

POST

/work-weixin/api/doApi

提示：登录模块为必要步骤。如需简化流程，可跳过步骤 1-4，直接通过控制台在线登录获取设备 id（guid）后，再进行接口调用。
⚠️ 重要提醒：创建/恢复设备5分钟内没有登录，此实例会自动清理

• 这是开启服务的第一步。通过该接口，您将获得一个虚拟设备id（guid），它是后续所有操作（如扫码、发消息）的唯一身份凭证。
• 重要提示：代理地区务必与微信手机登录所在地保持一致，严禁异省，否则可能导致登录失败。
• 设备类型推荐：ipad

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "method": "/client/createClient",
  "params": {
    "areaCode": "",
    "proxyUrl": "",
    "aid": "465612",
    "deviceName": "Ma sir的windows",
    "deviceType": 2,
    "clientVersion": ""
  }
}

请求示例代码

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": "/client/createClient",
  "params": {
    "areaCode": "",
    "proxyUrl": "",
    "aid": "465612",
    "deviceName": "Ma sir的windows",
    "deviceType": 2,
    "clientVersion": ""
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

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

修改于 2026-06-01 07:38:53

客户端用例

二维码-获取（步骤2）