批量获取联系人详情

POST

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

接口提示

根据 UserID 批量获取联系人详细资料。

可与获取群详情配合使用，进行添加群成员好友操作。

本接口支持单个或批量查询联系人基本信息。

联系人详情可能存在一定同步延迟，业务侧建议做好缓存与补偿刷新。

请求参数

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/batchGetUserinfo",
  "params": {
    "guid": "",
    "userIdList": [
      "{{userId}}",
      "{{userId}}",
      "{{userId}}"
    ]
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "contactList": [
      {
        "acctid": "",
        "alias": "",
        "avatarUrl": "https://cdn.wecomapi.com/demo/avatar.png",
        "gender": 1,
        "groupId": "0",
        "internationCode": "",
        "mobile": "",
        "nickname": "K",
        "realName": "",
        "userId": "7881306623159",
        "email": "",
        "job": "",
        "unionId": "ozynqs7z0RuBSNdgnQ8TBPw"
      },
      {
        "acctid": "",
        "alias": "",
        "avatarUrl": "https://cdn.wecomapi.com/demo/avatar.png",
        "gender": 0,
        "groupId": "0",
        "internationCode": "",
        "mobile": "",
        "nickname": "呵呵",
        "realName": "",
        "userId": "78813014092950",
        "email": "",
        "job": "",
        "unionId": "ozynqo_d7fu6g4a2Jbkzm2Rns"
      }
    ]
  }
}

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

内部联系人列表

搜索联系人