外部联系人与好友申请列表

POST

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

接口提示

分页获取外部联系人列表或好友申请列表。

bizType=1 用于获取联系人列表，bizType=2 用于获取好友申请列表。

本接口返回联系人简要信息，如需完整资料请调用批量获取联系人详情。

联系人数据建议落库保存，避免高频重复拉取。

请求参数

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/getWxContactList",
  "params": {
    "guid": "",
    "currentSeq": 6804514,
    "limit": 100,
    "bizType": 1
  }
}'

响应示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "currentSeq": 6804717,
    "limit": 0,
    "contactCount": 2,
    "hasMore": false,
    "contactList": [
      {
        "acctid": "",
        "addTime": 0,
        "alias": "",
        "avatarUrl": "http://wx.qlogo.cn/mmhead/7N2JRaWooRCIia4S8nLx6LAfoPd4PUkmZUYrsFHUhfKTTpOlmKAhVlo4LSpc7yxmSWDiaCrwTBmjw/0",
        "contactType": 2,
        "corpFullName": "",
        "corpId": "1970325134026788",
        "corpName": "",
        "desc": "",
        "gender": 1,
        "groupId": "0",
        "internationCode": "",
        "itemFlag": 2,
        "job": "",
        "labelList": null,
        "mobile": "",
        "nickname": "张三",
        "position": "",
        "realName": "",
        "remark": "",
        "unionid": "ozynqsms7s3ShYt_5TbCQp6xvDG0",
        "applyReason": "我是张三",
        "companyRemark": "",
        "mobileRemark": [],
        "sourceInfo": {
          "addSource": 54,
          "applyMode": 2,
          "opUserId": 0,
          "sourceRoomId": 0
        },
        "userId": "7881303197908577",
        "seq": 6756679,
        "createSeq": 6756676
      }
    ]
  }
}

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

退出当前设备

内部联系人列表