调用该接口在分享用户接受分享前,发起者取消分享。
路径 | /uc/cancelShare |
版本号 | 1.0.7 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 3000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
recordIdList | List | 否 | ["c2c481c8b90549fabe91****adafe303","d3c66fd984504e1c954e7f5****726f4"] | 分享记录列表,recordIdList和batchId不可同时为空。 |
batchId | String | 否 | 批次 ID。recordIdList和batchId不可同时为空。 传入 batchId 时,将同意或拒绝批次内所有设备的分享。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | Int |
接口返回码。200表示成功。 |
|
message | String |
调用失败时,返回的出错信息。 |
|
localizedMsg | String |
本地语言的错误消息。 |
示例
请求示例
{
"id": "1509086454180",
"version": "1.0",
"request":{
"apiVer": "1.0.7",
"iotToken": "token"
},
"params":{
"recordIdList":[
"c2c481c8b90549fabe91****adafe303",
"d3c66fd984504e1c954e7f5****726f4"
],
"batchId": "value1"
}
}
正常返回示例
JSON
格式
{
"code":200,
"id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}
异常返回示例
JSON
格式
{
"code":2093,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"forbiddentorepeatcancelsharing."
}