搜索联系人

POST

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

接口提示

通过关键词搜索联系人信息。

请求参数

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": "/contact/searchContact",
  "params": {
    "guid": "",
    "keyword": "188****8888"
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "searchStatus": 1,
    "workUserInfo": {
      "avatarUrl": "https://wework.qpic.cn/ww****",
      "corpId": 19703251983916,
      "gender": 1,
      "name": "企业微信账号信息",
      "ticket": "3024929DF1013****98BEDC60891BF8FED46265",
      "unionId": "ozynqsgFza**cKFm-luktM",
      "userId": 16888565768657
    },
    "wxUserInfo": {
      "avatarUrl": "http://wx.qlogo.cn/mm****zE/0",
      "gender": 1,
      "name": "微信账号信息",
      "unionId": "orFrbsoS********KqOxM4bU7g",
      "userId": 788130077941785
    }
  }
}

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

批量获取联系人详情

通过二维码查询联系人