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