获取访问凭证

开发中

GET

/corp-service/v1/access-tokens

接口描述：外部对接的应用服务器使用corp_id, corp_authorization和corp_secret，去获取访问凭证access_token，用于通讯录相关的操作。
请求地址： https://service.cheng-xun.cn/api/corp-service/v1/access-tokens?corp_id={corp_id}&corp_secret={corp_secret}
请求方式： GET
请求 Body：无

请求参数

Authorization

Query 参数

corp_id

number

组织id

必需

corp_secret

string

永久授权码

必需

<= 256 字符

Header 参数

User-Agent

string

可选

默认值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://service.cheng-xun.cn/api/corp-service/v1/access-tokens?corp_id=&corp_secret=' \
--header 'User-Agent: CX'

返回响应

🟢200成功

application/json

Body

err_code

integer

错误码

必需

err_msg

string

错误描述

必需

access_token

string

访问凭证

必需

256位

expires_in

integer

有效期时间

必需

access token的有效期时间（单位：秒）通常2个小时

示例

{
    "err_code": 0,
    "err_msg": "success",
    "access_token": "bk8W2pEL58VncQ034Uit7c5MctB1bEX7_2Em71JN6IXBDL0NJRZnRwabl5WJS1m3l_squ4xPbFiO9FUv18Betr78MG25m66KL9_06sTQRaXog8Bs6WZ5Bbj969l4D9SR0H4",
    "expires_in": 7200
}

修改于 2025-04-01 02:36:03

换取企业永久授权码

获取全量通讯录