1.1 获取accessToken
# 1.1 获取accessToken
# 接口说明
1、根据appId和appSecret获取access_token(接口令牌,调用别的接口都需要此参数),此接口调用次数限制为60次/小时,请注意在本地或者redis中缓存获取到的access_token,避免重复获取达到上限,造成接口调用失败。
2、access_token的有效期为7200秒,为了考虑兼容性问题,所以请保持缓存时间为7100秒左右,到期请调用手动刷新
3、需要注意凭证请求Content-Type 为 application/x-www-form-urlencoded 或 URL地址栏传参,当前此接口暂时不支持application/json传参
# 接口URL
{开放平台域名地址}/openApi/open/access_token/create
# HTTP请求方式
POST
# 公共参数
| 参数名称 | 参数类型 | 是否必须 | 描述 |
|---|---|---|---|
| appId | String | 是 | 由百福得向客户方发放 |
| grant_type | String | 是 | 固定字符串为client_credential |
| timestamp | String | 是 | 毫秒级时间戳,以Java为例,取System.currentTimeMillis()。百福得接口允许的毫秒级时间戳偏差为5分钟,偏差超过5分钟的请求将被拒绝(以服务器为准)。 |
| sign | String | 是 | 签名 |
| version | String | 否 | 业务接口版本号,如1.0.0 |
# 请求示例
POST /openApi/open/access_token/create HTTP/1.1 Content-Type: application/x-www-form-urlencoded appId=123456&grant_type=client_credential&sign=27e1f7ase213213ae2bf3672fd9101ba010a2434c119×tamp=16207106484581
2
3
4
# 返回参数说明
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| code | String | 返回码 |
| msg | String | 如果错误,返回错误信息。 |
| data | TokenResponse | 如果没有错误,返回业务数据 |
# TokenResponse
| 参数名称 | 参数类型 | 描述 |
|---|---|---|
| access_token | String | token访问令牌 |
| expires_in | integer | token的有效时长,单位:s(秒) |
# 返回示例
{
"code": 0,
"data": {
"access_token": "cde2c369fab499c0bf0643bb1844e70c",
"expires_in": 7200
},
"msg": "OK"
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8