创建设备

POST

/api/qw/doApi

说明

使用此API登录，每次都会验证6位code码。为避免频繁验证，推荐使用恢复实例API来替代本接口。

guid可以自行生成，如时间戳+特定业务规则（如客服务代号、id等）+ 随机数=>生成md5后，转为uuid即可

一个实例(Guid)可以理解为一个ipad(或者其它)设备。

在新的实例上登陆，需要微信验证码验证

在已登陆过的实例上重新登陆，可以免验证码登陆（手机端强制踢下线仍需要扫码，但可免验证码登陆）

实例上手动注销，重新登陆时，可以手动登陆，但无需扫码、验证code码

在新实例上登陆时，如果该企微账户有在老实例上已登录，会尝试顶号

sdk会定时清理非登录状态的实例，保证机器资源有效利用

请求参数

Header 参数

Body 参数application/json

示例

{
  "method": "/client/createClient",
  "params": {
    "proxyUrl": "",
    "areaCode": 320000,
    "deviceName": "stone的ipad",
    "deviceType": 0,
    "clientVersion": "" //默认稳定版不需要传
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/api/qw/doApi' \
--header 'X-QIWEI-TOKEN: {{tokenId}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "method": "/client/createClient",
  "params": {
    "proxyUrl": "",
    "areaCode": 320000,
    "deviceName": "stone的ipad",
    "deviceType": 0,
    "clientVersion": "" //默认稳定版不需要传
  }
}'

返回响应

🟢200成功

application/json

Body

示例

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

修改于 2026-03-12 05:47:05

实例管理

恢复实例