获取访问凭据

POST

/open-api/access_token/get

获取 access_token 是调用微伴开放API接口的第一步，相当于创建了一个登录凭证，其它的业务API接口，都需要依赖于 access_token 来鉴权调用者身份。

注意：和惯例不同，获取访问凭据请求采用 POST 方法，这是为了防止 secret 参数放在 url 中被留在请求日志中影响安全性。调用此接口需购买基础席位

请求参数

Body 参数application/json

corp_id

string

企业id

必需

secret

string

企业秘钥

必需

示例

{
    "corp_id": "{{corp_id}}",
    "secret": "{{secret}}"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.weibanzhushou.com/open-api/access_token/get' \
--header 'Content-Type: application/json' \
--data-raw '{
    "corp_id": "",
    "secret": ""
}'

返回响应

🟢200成功

application/json

Body

access_token

string

必需

errcode

integer

必需

errmsg

string

必需

expires_in

integer

必需

示例

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

🟢200正常返回

修改于 2025-04-29 01:49:39

评论工单回调

获取员工列表