数据多次上传，该 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设备服务提供方。

  • 1：开放平台。
  • 2：物联网平台。
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

是否调用成功。

  • true：调用成功。
  • false：调用失败。

示例

请求示例

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
}

错误码

错误码详细信息，请参见错误码。