开发文档免费试用

企业微信获取联系人基本信息 API

「获取联系人基本信息」接口属于青鸾开放平台的「联系人」能力，用于读取与管理企业微信的内部成员、外部客户与好友申请。通过语义化 HTTP API 调用，无需对接复杂底层即可快速集成，常用于 SCRM、客服系统、私域运营与营销自动化等场景。

免费试用本接口   查看完整文档

接口地址

POSThttps://api.qingluanbot.com/wecom/contacts/batch-get-userinfo

请求示例（cURL）

curl -X POST 'https://api.qingluanbot.com/wecom/contacts/batch-get-userinfo' \
  -H 'X-Qingluan-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "instance_guid": "inst_xxxxxxxxxxxxxxxx",
    "userIdList": [
      "RECIPIENT_ID"
    ]
  }'

请求参数

参数类型必填说明
instance_guidstring必填青鸾实例 ID（标识一个企业微信在线实例）
userIdListarray必填—

响应

统一响应信封 { ok, code, message, request_id, data }，code=0 表示成功，每次响应都带 request_id（ql_ 前缀）便于排查。

如何接入

  1. 注册并登录青鸾开发者控制台（注册即自动生成 API Key）。
  2. 在「实例与回调」一键扫码上号，获得 instance_guid。
  3. 请求头携带 X-Qingluan-Key，调用本接口 POST /wecom/contacts/batch-get-userinfo。
  4. 如需接收消息/事件，配置 Webhook 回调地址即可。

相关接口

企业微信外部联系人&申请列表 API →企业微信内部联系人列表 API →企业微信搜索联系人 API →企业微信添加个微联系人 API →企业微信添加企微联系人 API →企业微信添加群成员好友 API →企业微信添加企微名片 API →企业微信添加单删联系人 API →

注册即免费试用

1 个企业微信实例 · 在线测试直接发起真实调用 · 支持 Java / Python / Go / Node.js / PHP / C#

免费开始