获取企业上下游通讯录分组下的企业详情列表

自建应用可通过该接口获取企业上下游通讯录的某个分组下的企业列表

参数说明：

如需获取该分组及其子分组的所有企业详情，需先获取该分组下的所有子分组，然后再获取子分组下的企业，逐层递归获取。

权限说明：

自建应用/代开发应用可调用，仅返回应用可见范围内的企业列表

上下游系统应用可调用，返回全部的企业列表

curl --location --request GET 'https://qyapi.weixin.qq.com/cgi-bin/corpgroup/corp/get_chain_corpinfo_list?access_token=ACCESS_TOKEN' \ --header 'Content-Type: application/json' \ --data-raw '{ "chain_id":"Chxxxxxx", "groupid":1, "need_pending":false, "cursor": "", "limit": 0 }'

{ "errcode": 0, "errmsg": "ok", "has_more": false, "next_cursor": "xxx", "group_corps": [ { "groupid": 2, "corpid": "wwxxxx", "corp_name": "美馨粮油公司", "custom_id": "custom_id", "invite_userid": "zhangsan", "pending_corpid": "wwxxxx", "is_joined": 1 } ] }

请求参数

Query 参数

access_token

必需

调用接口凭证。上游企业应用access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

chain_id

string

上下游id

必需

groupid

integer

必需

分组id。如果不填，表示根目录

need_pending

boolean

必需

是否需要返回未加入的企业。默认不返回

cursor

string

必需

开启分页使用，传入返回值next_cursor

limit

integer

>0开启分页功能。

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

group_corps

array [object {7}]

分组列表数据。

必需

groupid

integer

可选

企业所属上下游的分组id

corpid

string

可选

企业id，最多64个字节

corp_name

string

企业名称

可选

custom_id

string

可选

上下游企业自定义id，返回管理端批量导入上下游联系人时指定的企业自定义id，如未指定则该字段为空

invite_userid

string

可选

该上下游的邀请人的userid，仅上下游系统应用调用时返回

pending_corpid

string

可选

未加入企业id，未加入的企业返回

is_joined

string

企业是否已加入

可选

next_cursor

string

必需

下次请求时应传入的cursor

has_more

string

必需

开启分页时告知是否还有更多记录