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