数据多次上传,该 API用于向 IoT区块链可信应用系统多次上传数据,并且上传的数据必须由 IoT设备端进行签名 。
- 同一个数据Key,可以多次使用AttachDataWithSignature上传数据。
- 调用成功后,系统会进行异步处理,稍后需使用GetData查询数据,进行确认。
- 同一个数据Key多次上传,后续上传数据需等待前序数据确认上链完成。
业务管理方 |
业务使用方 |
---|---|
√ |
√ |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | AttachDataWithSignature |
系统规定参数。取值:AttachDataWithSignature。 |
ApiVersion | String | 是 | 1.0.0 |
API版本号,"1.0.0"。 |
IotAuthType | String | 是 | ID2 |
IoT认证方式。 ID2:阿里云Link ID²。 |
IotDataDigest | String | 是 | 94894989498FDDABD51698BD1A49BF1AFB0AA94FAA8DB65A689164BEED****** |
IoT数据Value摘要。 1. Value数据UTF-8编码。 2. SHA256运算,结果为32字节数据。 3. 转换为64字节字符串格式(大写字符)。 |
IotId | String | 是 | 183329761572**** |
IoT设备唯一标识。 |
IotIdServiceProvider | String | 是 | g9R4ghe**** |
IoT设备服务提供方标识。 |
IotIdSource | String | 是 | 2 |
IoT设备服务提供方。
|
IotSignature | String | 是 | 2~2~192ADFB498AA****~1579198300000~J8E891NAgAhwHBHm8******/hnswr698HSb09ahS8709bn9s03jg98u4jg****** |
IoT设备数据签名。 使用 IoT 设备安全 SDK 进行签名。 |
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=AttachDataWithSignature
&ApiVersion=1.0.0
&IotAuthType=ID2
&IotDataDigest=94894989498FDDABD51698BD1A49BF1AFB0AA94FAA8DB65A689164BEED******
&IotId=183329761572****
&IotIdServiceProvider=g9R4ghe****
&IotIdSource=2
&IotSignature=2~2~192ADFB498AA****~1579198300000~J8E891NAgAhwHBHm8******/hnswr698HSb09ahS8709bn9s03jg98u4jg******
&Key=0001_HB5jyvZWzwcM****_0X**_80aa976ac4d64a97bd45c71a509d****
&ProductKey=HB5jyvZWzwcM****
&Value=某公司某业务数据。
&<公共请求参数>
正常返回示例
XML
格式
<AttachDataWithSignatureResponse>
<Message></Message>
<RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
<Data></Data>
<Code>200</Code>
<Success>true</Success>
</AttachDataWithSignatureResponse>
JSON
格式
{
"Message": "",
"RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
"Data": "",
"Code": 200,
"Success": true
}
错误码
错误码详细信息,请参见错误码。