通过IoT设备签名后,上传阶段数据的摘要信息到区块链,并同时可以绑定所关联的其它阶段数据。
业务管理方 |
业务使用方 |
---|---|
√ |
√ |
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | UploadMPCoSPhaseDigestInfoByDevice |
系统规定参数。取值:UploadMPCoSPhaseDigestInfoByDevice。 |
ApiVersion | String | 是 | 1.0.0 |
API版本号,"1.0.0"。 |
BizChainId | String | 是 | 489973087549**** |
业务链标识。 |
DataKey | String | 是 | 32bfce96b4e2f9bec0f2ea5cc2f14ace1486cc146d5832d3a84e5332fe89**** |
数据唯一标识。 |
IotAuthType | String | 是 | ID2 |
IoT认证方式。 ID2:阿里云Link ID²。 |
IotDataDigest | String | 是 | 94894989498FDDABD51698BD1A49BF1AFB0AA94FAA8DB65A689164BEED****** |
IoT可信数据Value摘要。 1. Value数据UTF-8编码。 2. SHA256运算,结果为32字节数据转换为64字节字符串格式(大写字符)。 |
IotId | String | 是 | 183329761572**** |
IoT设备唯一标识。 |
IotIdServiceProvider | String | 是 | g9R4ghe**** |
IoT设备服务提供方标识。 |
IotIdSource | String | 是 | 2 |
IoT设备服务提供方。
|
IotSignature | String | 是 | 2~2~192ADFB498AA****~1579198300000~J8E891NAgAhwHBHm8******/hnswr698HSb09ahS8709bn9s03jg98u4jg****** |
IoT设备数据签名。 使用IoT设备安全SDK进行签名。 |
PhaseData | String | 是 | ebf44d78ae75288d7d0057a5ebf44d78a6b86d04502dcbda643c4d24ff2a**** |
阶段数据的SHA256摘要值,要求长度为64字符。 |
PhaseGroupId | String | 是 | 383860792287**** |
协同模型标识。 |
PhaseId | String | 是 | 644208887511**** |
阶段标识。 |
DataSeq | String | 否 | be350cd52b0f47846f93df7d0d4febd86025ee6c028a6b22a6ff1ac6d3a2**** |
数据序列号。 |
RelatedDataList | Json | 否 | [{"relatedPhaseId":"987823074334****","relatedDataKey":"be350cd52b0f47846f93df7d0d4febd86025ee6c028a6b22a6ff1ac6d3a2****","relatedPhaseData":"某公司某业务数据。","relatedDataSeq":"b71cca5502d8d7d0057a5ebf44d78ae75280436b86dcbda643c4d264ff2a****"}] |
关联数据列表。详情请参见下表RelatedData。 |
RelatedData
参数 |
类型 |
是否必选 |
示例值 |
描述 |
---|---|---|---|---|
relatedPhaseId |
String |
是 |
987823074334**** |
关联的数据阶段ID。长度要求64字节。 |
relatedDataKey |
String |
是 |
be350cd52b0f47846f93df7d0d4febd86025ee6c028a6b22a6ff1ac6d3a2**** |
关联的数据Key值。 |
relatedPhaseData |
String |
是 |
某公司某业务数据 |
关联的阶段数据。 |
relatedDataSeq |
String |
否 |
b71cca5502d8d7d0057a5ebf44d78ae75280436b86dcbda643c4d264ff2a**** |
关联的数据序列号。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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=UploadMPCoSPhaseDigestInfoByDevice
&ApiVersion=1.0.0
&BizChainId=489973087549****
&DataKey=32bfce96b4e2f9bec0f2ea5cc2f14ace1486cc146d5832d3a84e5332fe89****
&IotAuthType=ID2
&IotDataDigest=94894989498FDDABD51698BD1A49BF1AFB0AA94FAA8DB65A689164BEED******
&IotId=183329761572****
&IotIdServiceProvider=g9R4ghe****
&IotIdSource=2
&IotSignature=2~2~192ADFB498AA****~1579198300000~J8E891NAgAhwHBHm8******/hnswr698HSb09ahS8709bn9s03jg98u4jg******
&PhaseData=ebf44d78ae75288d7d0057a5ebf44d78a6b86d04502dcbda643c4d24ff2a****
&PhaseGroupId=383860792287****
&PhaseId=644208887511****
&<公共请求参数>
正常返回示例
XML
格式
<UploadMPCoSPhaseDigestInfoByDeviceResponse>
<Message></Message>
<RequestId>D5C69894-9709-4653-B3D8-25234034C2FC</RequestId>
<Data></Data>
<Code>200</Code>
<Success>true</Success>
</UploadMPCoSPhaseDigestInfoByDeviceResponse>
JSON
格式
{
"Message": "",
"RequestId": "D5C69894-9709-4653-B3D8-25234034C2FC",
"Data": "",
"Code": 200,
"Success": true
}
错误码
错误码详细信息,请参见错误码。