数据多次上传,该API用于向IoT区块链可信应用系统多次上传数据。
- 同一个数据Key,可以多次使用AttachData上传数据。
- 调用成功后,系统会进行异步处理,稍后需使用GetData查询数据,进行确认。
- 同一个数据Key多次上传,后续上传数据需等待前序数据确认上链完成。
业务管理方 |
业务使用方 |
---|---|
√ |
√ |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AttachData |
系统规定参数。取值:AttachData。 |
ApiVersion | String | 是 | 1.0.0 |
API版本号,"1.0.0"。 |
Key | String | 是 | 0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d**** |
数据Key唯一标识。 |
ProductKey | String | 是 | HB5jyvZWzwcM**** |
业务链编码。 |
Value | String | 是 | 某公司某业务数据。 |
数据Value。 |
BusinessId | String | 否 | 000000000000000000000000000000000000000000000000000000000001**** |
1. 用户业务ID,同一个Key,业务ID必须唯一。格式为64字符,合法字符范围[0-9,a-f,A-F]。 2. 如果不包含该参数,则返回当前Key最新数据。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | Integer | 200 |
响应状态码。 |
Data | String | 无 |
多余参数,请忽略。 |
Message | String | The system is busy. Please try again later. |
调用失败时,返回的出错信息。 |
RequestId | String | D5C69894-9709-4653-B3D8-25234034C2FC |
阿里云为该请求生成的唯一标识符。 |
Success | Boolean | true |
是否调用成功。
|
示例
请求示例
http(s)://ltl.cn-shanghai.aliyuncs.com/?Action=AttachData
&ApiVersion=1.0.0
&Key=0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d****
&ProductKey=HB5jyvZWzwcM****
&Value=某公司某业务数据。
&<公共请求参数>
正常返回示例
XML
格式
<AttachDataResponse>
<Message></Message>
<RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
<Data></Data>
<Code>200</Code>
<Success>true</Success>
</AttachDataResponse>
JSON
格式
{
"Message": "",
"RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
"Data": "",
"Code": 200,
"Success": true
}
错误码
错误码详细信息,请参见错误码。