获取应用共享信息 - Developer OpenAPI

上级/上游企业通过该接口可以获取某个应用分享给的所有企业列表。
特别注意，对于有敏感权限的应用，需要下级/下游企业确认后才能共享成功，若下级/下游企业未确认，则不会存在于该接口的返回列表
权限说明：
自建应用和第三方应用

请求参数

Query 参数

access_token

string

必需

调用接口凭证，上级/上游企业应用access_token

示例值:

ACCESS_TOKEN

Body 参数application/json

agentid

integer

必需

上级/上游企业应用agentid

business_type

integer

可选

填0则为企业互联/局校互联，填1则表示上下游企业

corpid

string

可选

下级/下游企业corpid，若指定该参数则表示拉取该下级/下游企业的应用共享信息

limit

integer

可选

返回的最大记录数，整型，最大值100，默认情况或者值为0表示下拉取全量数据

cursor

string

可选

用于分页查询的游标，字符串类型，由上一次调用返回，首次调用可不填

示例

{
  "agentid": 0,
  "business_type": 0,
  "corpid": "string",
  "limit": 0,
  "cursor": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

ending

integer

必需

1表示拉取完毕，0表示数据没有拉取完

corp_list

array [object {3}]

应用共享信息

必需

corpid

string

必需

下级/下游企业corpid

corp_name

string

下级/下游企业名称

必需

agentid

integer

必需

下级/下游企业应用id

next_cursor

string

必需

分页游标，再下次请求时填写以获取之后分页的记录，如果已经没有更多的数据则返回空

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "ending": 0,
  "corp_list": [
    {
      "corpid": "wwcorpid1",
      "corp_name": "测试企业1",
      "agentid": 1111
    },
    {
      "corpid": "wwcorpid2",
      "corp_name": "测试企业2",
      "agentid": 1112
    }
  ],
  "next_cursor": "next_cursor1111"
}