调用该接口获取云端资源Token。该接口对于同一个res,在Token失效前仅需调用一次。如果再次调用,会生成新的cloudToken,并导致之前的cloudToken失效。

路径 /cloud/token
版本号 1.0.1
协议 HTTPS
请求方法 POST
是否需要用户身份鉴权
超时时间 3000

请求参数

名称 类型 是否必选 示例值 描述
grantType String 授权类型,当前固定为project。
res String 授权的资源,需填写想要获得授权的projectId。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data JSON

响应的结果。

cloudToken String

云端Token。

expireIn Long

云端Token的有效期,单位:ms。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.1"
	},
	"params":{
		"grantType": "value0",
		"res": "value1"
	}
}

正常返回示例

JSON 格式

{
    "id": "1509086454180",
    "code": 200,
    "message": "success",
    "data": {
         "iotToken" : "iotToken",
	 "expiresIn" : 7200
    }
}

异常返回示例

JSON 格式

{
    "id": "1509086454180",
    "code": 400,
    "message": "error"
}