云端资源服务为云端管理的基础服务，通过该服务获取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
    }
}