全部产品

通用IoT设备数据上链场景

本文以文档摘要存证为示例,介绍通用IoT设备数据上链的操作流程。

场景描述

如下场景描述了,某个业务管理方开通存证与溯源服务之后,通过IoT设备对数据进行采集,之后通过业务系统中转对数据进行上链。

步骤一:服务开通

业务管理方,查看已开通的存证与溯源业务链列表。

API名称:ListProofChain

请求示例:

ListProofChainRequest request = new ListProofChainRequest();
request.setApiVersion("1.0.0");
request.setNum(1);
request.setSize(10);
ListProofChainResponse response = client.getAcsResponse(request);

响应结果:存证与溯源业务链列表。

{
    "num": 1,
    "pageData": [
        {
            "bizChainCode": "BMVPgwj2XSA7****",
            "bizChainId": "123498756487****",
            "dataTypeCode": "ED**",
            "name": "存证-业务链",
            "remark": "存证-业务链",
            "roleType": "ADMIN"
        }
    ],
    "size": 10,
    "total": 1
} 

步骤二:设备端SDK集成

请参考设备端SDK参考章节,下载设备端SDK,并在对应的平台进行集成。

步骤三:设备端SDK集成

IoT设备进行数据采集之后,并通过设备端API对采集的数据进行签名,请参考设备端API ltlGetSignature,签名结果如下图。

image

步骤四:数据上链

业务存证方使用存证编号进行数据存证,将IoT设备上报的数据通过业务系统进行数据上链。

API名称:SetDataWithSignature

请求示例:

SetDataWithSignatureRequest request = new SetDataWithSignatureRequest();
request.setApiVersion("1.0.0");
request.setProductKey("BMVPgwj2XSA7****");
request.setKey("0001_BMVPgwj2XSA7****_9B**_00000000000000000000000000000001");
request.setValue("Proof-Data");
// 设置签名信息
request.setIotAuthType("ID2");
request.setIotId("00FFFF098598F3BDD822****");
request.setIotIdServiceProvider("hKpHMh2****");
request.setIotDataDigest("3A6EB0790F39AC87C94F3856B2DD2C5D110E6811602261A9A923D3BB23AD****");
request.setIotSignature("3~2~0102026374060708~1608810005540~YB+pzSxYT2Pe5RC3kZB9MSBMEBo6hQ4RrfIODSBC1D4vm51M1Yt0nfHUk7jQ****");
request.setIotIdSource("2");
SetDataWithSignatureResponse response = client.getAcsResponse(request);
requestId:BEDF2DDB-67E5-4152-8AAF-C2E11B2EFB36
request success.