调用该接口实现被分享者同意或拒绝分享请求。
路径 | /uc/confirmShare |
版本号 | 1.0.7 |
协议 | HTTPS |
请求方法 | POST |
是否需要用户身份鉴权 | 是 |
超时时间 | 15000 |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
recordIdList | List | 否 | ["c2c481c8b90549fa****d655adafe303","d3c66fd98450****954e7f5ea43726f4"] | 分享记录列表。单次同意或拒绝分享的数量上限为 10 个。recordIdList和batchId不可同时为空。 |
agree | Int | 是 | 1 | 0(表示不同意);1(表示同意)。 |
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":[
"c2c481c8b90549fa****d655adafe303",
"d3c66fd98450****954e7f5ea43726f4"
],
"agree":1,
"batchId": "value2"
}
}
正常返回示例
JSON
格式
{
"code":200,
"id":"bb179e80-39fd-4a79-ba97-48ca87a3f5c5"
}
异常返回示例
JSON
格式
{
"code":2092,
"id":"4fa207ca-fffd-48bb-94b8-e6f7ca6c99c3",
"localizedMsg":"请求错误",
"message":"forbiddentorepeatrejectsharing."
}