联系人详情-批量

POST

/work-weixin/api/doApi

• 本接口用于查询联系人基本信息，支持批量查询。
• 允许查询好友、非好友的联系人信息。
• 查询联系人详情时，需先调用外部联系人分页获取用户 userid，并将联系人数据缓存至本地，再根据 userid 查询详情。

请求参数

Header 参数

Body 参数application/json必填

示例

{
   "method": "/contact/batchGetUserinfo",
   "params": {
      "guid": "",
      "userIdList": [
         "168*****5548"
      ]
   }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/work-weixin/api/doApi' \
--header 'X-QIWEI-TOKEN;' \
--header 'Content-Type: application/json' \
--data '{
   "method": "/contact/batchGetUserinfo",
   "params": {
      "guid": "",
      "userIdList": [
         "168*****5548"
      ]
   }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "contactList": [
            {
                "acctid": "string",
                "alias": "string",
                "avatarUrl": "string",
                "corpId": "string",
                "gender": 0,
                "groupId": "string",
                "internationCode": "string",
                "mobile": "string",
                "nickname": "string",
                "realName": "string",
                "userId": "string"
            }
        ]
    },
    "msg": "string"
}

修改于 2026-06-02 08:25:52

设置回调URL

外部联系人分页