调用该接口获取云端资源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" : 7200000
    }
}

异常返回示例

JSON格式

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