数据上传,该API用于向LTL上传数据,并且上传的数据必须由IoT设备端进行签名。

调用成功后,系统会进行异步处理,稍后需使用GetData查询数据,进行确认。

可访问账号:

业务管理方

业务使用方

请求参数

名称 类型 是否必选 示例值 描述
Action String SetDataWithSignature

系统规定参数。取值:SetDataWithSignature。

ApiVersion String 1.0.0

API版本号,"1.0.0"。

IotAuthType String ID2

IoT认证方式。

ID2:阿里云Link ID²。

IotDataDigest String 31A200471049AEA3B8459455B4447D05DD1290A875A17792F71D5550F048****

IoT可信数据Value摘要:

1. Value数据UTF-8编码。

2. SHA256运算,结果为32字节数据。

3. 转换为64字节字符串格式(大写字符)。

IotId String 00CCCC098D98F2BDD8BB****

IoT设备唯一标识。

IotIdServiceProvider String kKpACh5****

IoT设备服务提供方标识。

IotIdSource String 2

IoT设备服务提供方。

  • 1:开放平台。
  • 2:物联网平台。
IotSignature String 3~2~010253040257****~1599722505821~50sZwIXt9jtTTIoGAkEs4THSyCMghVVaYO1w2AcvQf0vm51MQYt0nfHUT7jQ****

IoT设备数据签名。使用IoT设备安全SDK进行签名。

Key String 0001_HB5jyvZWzwcMFSFg_0X58_80aa976ac4d64a97bd45c71a509d****

数据Key唯一标识。

ProductKey String HB5jyvZWzwcM****

业务链编码。

Value String 某公司某业务数据。

数据Value。

返回数据

名称 类型 示例值 描述
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=SetDataWithSignature
&ApiVersion=1.0.0
&IotAuthType=ID2
&IotDataDigest=31A200471049AEA3B8459455B4447D05DD1290A875A17792F71D5550F048****
&IotId=00CCCC098D98F2BDD8BB****
&IotIdServiceProvider=kKpACh5****
&IotIdSource=2
&IotSignature=3~2~010253040257****~1599722505821~50sZwIXt9jtTTIoGAkEs4THSyCMghVVaYO1w2AcvQf0vm51MQYt0nfHUT7jQ****
&Key=0001_HB5jyvZWzwcMFSFg_0X58_80aa976ac4d64a97bd45c71a509d****
&ProductKey=HB5jyvZWzwcM****
&Value=某公司某业务数据。
&<公共请求参数>

正常返回示例

XML 格式

<SetDataWithSignatureResponse>
      <Message></Message>
      <RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
      <Data></Data>
      <Code>200</Code>
      <Success>true</Success>
</SetDataWithSignatureResponse>

JSON 格式

{
    "Message": "",
    "RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
    "Data": "",
    "Code": 200,
    "Success": true
}

错误码

错误码详细信息,请参见错误码