数据上传,该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设备服务提供方。
|
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 |
是否调用成功。
|
示例
请求示例
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
}
错误码
错误码详细信息,请参见错误码。