获取 access_token

概述

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

如何获取 appid 和 app_secret

登录谱蓝云 SCRM 系统后台，在设置--开发中心创建应用，创建完成后即可获取到应用的 client_id 和对应的 client_secret。

注意事项

开发者需要缓存 access_token，用于后续接口的调用（注意：不能频繁调用 get-token 接口，否则会受到频率限制拦截）。当 access_token 失效或过期时，需要重新获取。

access_token 的有效期通过 expires_in 来传达，正常情况下为 7200 秒（2小时），有效期内重复获取返回相同结果，过期后获取会返回新的access_token。

access_token 至少保留 512 字节的存储空间。

可能会出于运营需要，提前使 access_token 失效，开发者应实现access_token 失效时重新获取的逻辑。

请求参数

Query 参数

grant_type

enum<string>

必需

授权类型，固定为 client_credentials

枚举值:

client_credentials

client_id

string

必需

谱蓝云系统生成的的应用 ID

示例值:

client_secret

string

必需

谱蓝云系统生成的的应用 secret

示例值:

Header 参数

Authorization

string

可选

默认值:

Bearer {{auth_token}}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0 表示成功，非 0 表示失败

msg

string

状态码描述

必需

data

object

必需

access_token

string

获取到的凭证

必需

最长为 512 字节

refresh_token

string

刷新 token

必需

expires_in

number

凭证有效时间

必需

单位（秒）

token_type

string

必需

示例

{
    "code": 0,
    "data": {
        "access_token": "94eb05ac4810410eb7b2f3515045f6c9",
        "refresh_token": "29f790e4a58a44a4b72817fc6acf719e",
        "token_type": "bearer",
        "expires_in": 3555
    },
    "msg": ""
}

概述#

如何获取 appid 和 app_secret#

注意事项#

请求参数

示例代码

返回响应

概述

如何获取 appid 和 app_secret

注意事项