调用该接口在分享用户接受分享前,发起者取消分享。

路径 /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."
}