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

GET

http://127.0.0.1/cgi-bin/corpgroup/corp/get_chain_corpinfo_list

企业内部开发/上下游/获取上下游信息

最后修改时间：2022-08-30 03:03:36

责任人：未设置

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

请求参数

Query 参数

access_token

string

必需

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

示例值:

ACCESS_TOKEN

Body 参数application/json

chain_id

string

上下游id

必需

groupid

integer

可选

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

fetch_child

integer

可选

递归获取指定分组及其子分组的所有企业。1表示递归获取该分组下所有企业，0表示指定分组下所有企业，默认为0

示例

{
  "chain_id": "string",
  "groupid": 0,
  "fetch_child": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'http://127.0.0.1/cgi-bin/corpgroup/corp/get_chain_corpinfo_list?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "chain_id": "string",
    "groupid": 0,
    "fetch_child": 0
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

group_corps

array [object {4}]

分组列表数据。

必需

groupid

integer

可选

企业所属上下游的分组id

corpid

string

可选

企业id，最多64个字节

corp_name

string

企业名称

可选

custom_id

string

可选

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

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "group_corps": [
    {
      "groupid": 2,
      "corpid": "wwxxxx",
      "corp_name": "美馨粮油公司",
      "custom_id": "wof3du51quo5sl1is"
    }
  ]
}

获取上下游通讯录分组

获取下级/下游企业的access_token