获取下级/下游企业的access_token

POST

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

企业内部开发/上下游

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

责任人：未设置

获取应用可见范围内下级/下游企业的access_token，该access_token可用于调用下级/下游企业通讯录的只读接口。
权限说明：
自建应用

请求参数

Query 参数

access_token

string

必需

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

示例值:

ACCESS_TOKEN

Body 参数application/json

corpid

string

必需

已授权的下级/下游企业corpid

business_type

integer

可选

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

agentid

integer

必需

已授权的下级/下游企业应用ID

示例

{
  "corpid": "wwabc",
  "business_type": 1,
  "agentid": 1111
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://127.0.0.1/cgi-bin/corpgroup/corp/gettoken?access_token=ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corpid": "wwabc",
    "business_type": 1,
    "agentid": 1111
}'

返回响应

🟢200成功

application/json

Body

errcode

integer

必需

出错返回码，为0表示成功，非0表示调用失败

errmsg

string

返回码提示语

必需

access_token

string

必需

获取到的下级/下游企业调用凭证，最长为512字节

expires_in

integer

必需

凭证的有效时间（秒）

示例

{
  "errcode": 0,
  "errmsg": "ok",
  "access_token": "accesstoken000001",
  "expires_in": 7200
}

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

获取下级/下游企业小程序session