获取访问Token

访问令牌或访问token，是API接口调用的凭证，用于校验API接口调用是否有权限。第三方应用程序需要访问一个token，并在每个请求中携带访问令牌来访问API。

前提条件

你已在星纵物联开放平台中创建一个应用 并获得了以下内容：
  • 服务器地址
  • 客户端ID
  • 客户端密钥

请求 URL

POST {base_url}/oauth/token

请求参数

表 1. Body 参数
参数 是否必填 类型 说明
client_id 是 String 星纵物联开放平台上获取 客户端ID作为用户名。
client_secret 是 String

星纵物联开放平台上获取客户端密钥 作为密码。
grant_type 是 String 请求访问token的OAuth授权类型。

有效值: client_credentials

响应参数

参数 类型 说明
data Object<Token_Details> 请求token的详细信息。
status String API的请求结果。
  • Success
  • Failed
requestId String 唯一的请求ID ,可用于快速定位请求。
令牌详情Token_Details
参数 类型 说明
access_token String API接口调用凭证。所有的请求都需要带一个访问token。
注： 如果访问token被泄露，你可以在星纵物联开放平台上重新生成一个客户端密钥并请求一个新的，之前的将自动失效。
refresh_token String 用于获取新的访问token和刷新token。
expires_in Integer 访问token有效时长。

单位: 秒（s）
refresh_token_expires_in Integer 刷新token有效时长。

单位：秒（s）

示例

请求示例
POST /oauth/token HTTP/1.1
Host: milesight.demo.com
Content-Type: x-www-form-urlencoded
User-Agent: OpenAPI

client_id=ee6ad650-7d33-414d-bafb-xxxxxxxxxxxx&client_secret=zy6ClNXcTkzTtfPB1tswxxxxxxxxxxxx&grant_type=client_credentials
响应示例
HTTP/1.1 200 OK
{
    "data": {
        "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzQ0NzUwODY0NjY2MDA5NjIifSwiZXhwIjoxNzAyNDU1MDM1LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJlYTRiZjYyMS1kMTFiLTRiNmItYTQ5Yi00YWZmODA2ODM4NDAiLCJjbGllbnRfaWQiOiJlZTZhZDY1MC03ZDMzLTQxNGQtYmFmYi0wODM3YjNlMzQzMWQiLCJ0cyI6MTcwMjQ1MTQzNTMzN30.CY_fgSs_Ew7HYF1QgBFOHgJf_YyWo59xbz4iPCCK9zpzqoSX4mRcOo0SpYSk2IkupiZYfw2ZtXb6XNhYLN--wXXuikxWtbxGj4LSO4baUDlzIAZ03dJzZX0nX12b3bmgNtKi6qxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "refresh_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzQ0NzUwODY0NjY2MDA5NjIifSwiYXRpIjoiZWE0YmY2MjEtZDExYi00YjZiLWE0OWItNGFmZjgwNjgzODQwIiwiZXhwIjoxNzA1MDQzNDM1LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiI4MGRkZDMzMy0wZGVlLTQwYzMtODU3Ny0xNzViOTJlMzIwZDUiLCJjbGllbnRfaWQiOiJlZTZhZDY1MC03ZDMzLTQxNGQtYmFmYi0wODM3YjNlMzQzMWQiLCJ0cyI6MTcwMjQ1MTQzNTMzN30.YN-JqX9RDxAfTElL2ftojqWhJCNyYdtgezRKpFMTUp0H7mtN-07kCL1Ue72vG58gfPh_C87V6joCJsR7_WfpUvQX6kn4jpLRM3JDT0A8D8lk5w5Mul6lBd6bHEtXNxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "expires_in": 3599,
        "refresh_token_expires_in": 2591999
    },
    "status": "Success",
    "requestId": "72fea33ad6f721a3a218cc6f60c5fff1"
}