云端资源服务

更新时间:2018-10-19 11:29:34

服务描述

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

失效机制

  • cloudToken的有效时间通过expireIn来返回,默认有效时长为7200秒。

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

云端资源类型

名称 授权类型(grantType) 资源(res)
项目资源 project 项目ID

获取云端资源Token

定义描述

path 版本 描述
/cloud/token 1.0.0 获取云端资源Token

请求参数

参数 类型 必填 描述
grantType String 授权类型
res String 授权的资源

返回参数

参数 类型 描述
cloudToken String 云端Token
expiresIn int Token有效期

示例

请求示例

{
    "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" : 7200
    }
}

错误码

错误码 错误信息 详细描述

刷新云端资源Token

定义描述

path 版本 描述
/cloud/token/refresh 1.0.0 获取云端Token

请求参数

参数 类型 必填 描述
cloudToken String

返回参数

参数 类型 描述
cloudToken String 云端Token
expiresIn int Token有效期

示例

请求示例

{
    "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" : 7200
    }
}

错误码

错误码 错误信息 详细描述

results matching ""

    No results matching ""