云端資源服務為云端管理的基礎服務，通過該服務獲取IoT云端資源的令牌，后續請求通過該令牌訪問資源。

失效機制

  • cloudToken的有效時間通過expireIn來返回，默認有效時長為7200000毫秒（2小時）。
  • cloudToken刷新后老cloudToken在5分鐘內可用，確保第三方業務可以平滑過渡。

云端資源類型

名稱 授權類型（grantType） 資源（res）
項目資源 project 項目ID

獲取云端資源token

定義描述

path 請求方法 版本 描述
/cloud/token POST 1.0.0 獲取云端資源Token；該接口對于同一個res（projectId，參見請求參數說明）在token失效前僅需要調用一次，如果再次調用，則會生成新的cloudToken，并會導致之前的cloudToken失效

請求參數

參數 類型 必填 描述
grantType String 是 授權類型，當前固定為project
res String 是 授權的資源，需填寫想要獲得授權的projectId

返回參數

參數 類型 描述
cloudToken String 云端Token
expiresIn long Token有效期（單位：ms）

示例

  • 請求示例 
    {
    "id": "1509086454180",
    "version": "1.0", 
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "grantType": "project",
        "res": "xxxxxx"
    }
}
  • 正常返回示例 
    {
    "id": "1509086454180",
    "code": 200,
    "message": "success",
    "data": {
        "cloudToken" : "cloudToken",
        "expiresIn" : 7200000
    }
}

刷新云端資源token

定義描述

path 版本 描述
/cloud/token/refresh 1.0.0 刷新云端Token

請求參數

參數 類型 必填 描述
cloudToken String 是 -

返回參數

參數 類型 描述
cloudToken String 云端Token
expiresIn long Token有效期（單位：ms）

示例

  • 請求示例 
    {
    "id": "1509086454180",
    "version": "1.0", 
    "request": {
        "apiVer": "1.0.0",
        "cloudToken":"cloudToken"
    },
    "params": {
        "cloudToken": "cloudToken"
    }
}
  • 正常返回示例 
    {
    "id": "1509086454180",
    "code": 200,
    "message": "success",
    "data": {
        "cloudToken" : "cloudToken",
        "expiresIn" : 7200000
    }
}