① 创建设备并获取 guid

POST

http://manager.wecomapi.com/wecom/finder/api

接口提示

初始化云端设备实例，并返回后续接口需要使用的唯一标识 guid。

后续登录、联系人、消息、群组、文件等接口通常都需要携带该 guid。

获取 guid 后，继续调用获取登录二维码完成扫码登录。

如使用代理，代理地区建议与账号常用登录地区保持一致，避免因异地环境导致登录异常。

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功

application/json

请求成功时返回统一响应结构，具体字段以 data 内容为准。

Bodyapplication/json

请求示例

Shell

JavaScript

Java

Swift

curl --location 'http://manager.wecomapi.com/wecom/finder/api' \
--header 'WECOM-TOKEN: ' \
--header 'Content-Type: application/json' \
--data '{
  "method": "/client/createClient",
  "params": {
    "proxyUrl": "",
    "areaCode": 320000,
    "deviceName": "测试设备",
    "deviceType": 0,
    "clientVersion": ""
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "guid": "a3318ad6-5544-4a4f-a1bb-2aa667b2ipad"
  }
}

修改于 2026-07-03 10:03:16

配置消息回调地址

② 获取登录二维码