云端资源服务

更新时间：2019-05-07 11:53:09

云端资源服务

云端资源服务为云端管理的基础服务，通过该服务获取IoT云端资源的令牌，后续请求通过该令牌访问资源。

失效机制

  • cloudToken的有效时间通过expireIn来返回，默认有效时长为7200000毫秒（2小时）。

  • cloudToken刷新后老cloudToken在5分钟内可用，确保第三方业务可以平滑过渡。

云端资源类型

名称 授权类型（grantType） 资源（res）
项目资源 project 项目ID

获取云端资源token

定义描述

path 版本 描述
/cloud/token 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
    }
}

错误码

请参考公共错误码

results matching ""

    No results matching ""