# 服务端token接口
说明
该接口需要联系商务开通权限。
# 获取服务端的token
接口地址
https://auth.iflyos.cn
获取服务客户端的访问令牌
该接口是用于获取第三方云端
访问OS云端接口
的访问令牌server_client_access_token
,只能用在服务端上使用,不应该将client_secret
暴露在客户端和设备端
POST /oauth/token
请求body
{
"grant_type": "client_credentials",
"client_id": "{{SERVER CLIENT ID}}",
"client_secret": "{{SERVER CLIENT SECRET}}"
}
参数说明
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
grant_type | string | 是 | 固定取值为client_credentials |
client_id | string | 是 | 服务端的appid ,aiui_support@iflytek.com 申请获取 |
client_secret | string | 是 | 服务端的app_secret ,同上 |
响应
Status: 200 OK
{
"token_type": "bearer",
"refresh_token": "nP90c4YeHxxx1O83zmUhv_oH3xxxxx5fRU3WqNAZBnycdB",
"expires_in": 86400000,
"created_at": 1547709087,
"access_token": "2bUyll3xxxzMI53d2oac6cPkxxxxx4wfszqC1T8Cvvm9Pxj"
}
参数说明:
参数名 | 类型 | 必有 | 说明 |
---|---|---|---|
access_token | string | 是 | 服务端token,即server_client_access_token ,是用于访问其它接口的令牌,需要维护 |
created_at | string | 是 | 令牌创建的时间 |
expires_in | string | 是 | 令牌有的效时长 |
refresh_token | string | 是 | 用于刷新access_token 的令牌 |
注意
- 获取
Token信息
后,应该将Token信息
持久化,不应该经常去调用,如果频繁调用,可能会引起OS授权服务
的限制; - 使用
access_token
前,应先检查是否有已经过期。是的话,应该先刷新新的access_token
,覆盖保存新的token信息
,再使用新的access_token
去调用其它接口; - 刷新
access_token
的方法请参考:刷新AccessToken文档 (opens new window)
# 刷新云端token接口
POST https://auth.iflyos.cn/oauth/token
Content-Type: application/json
请求header
"Authorization": "Bearer {{server_client_access_token}}"
参数名 | 参数说明 | 类型 | 参数示例 | 必填 |
---|---|---|---|---|
refresh_token | 获取token时得到的refresh_token | string | c6AbJgXHhg5N1OMHIQSjF43k47Tua-jv24uwfZEsAHhCGK3MrstRRnn0szypLMsX | 是 |
grant_type | 授权类型,为"refresh_token" | string | refresh_token | 是 |
响应示例
Status: 200 OK
{
"token_type": "bearer",
"refresh_token": "D7IhIcfBCe9y4CFow9CYeOvCNOjOHWoBtXKYK6Gc9D_V91hyqjxAv8JuS6o368R8",
"expires_in": 86400000,
"created_at": 1555669003,
"access_token": "bCmbscoej0BI0f70-Wi03qCCDF_4RyWKAp7jQeQjyE0akiWRp6uqnnmb5w_982zl"
}