《数据流通区块链智能合约API技术规范》征求意见稿.pdf

T/GZBDXXX—XXXX

数据流通区块链智能合约API技术规范

1范围

本文件规定了数据流通区块链智能合约API的术语和定义、基本原则、接口参数、功能要求、性能

要求、安全要求和测试要求等。

本文件适用于数据流通区块链存证智能合约API的设计、开发和应用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T42752区块链和分布式记账技术参考架构

GB/T43572区块链和分布式记账技术术语

3术语和定义

GB/T42752、GB/T43572界定的以及下列术语和定义适用于本文件。

3.1

应用编程接口applicationprogramminginterface

软件系统不同组成部分衔接的约定。

[来源：GB/T42030—2022，3.2]

4缩略语

下列缩略语适用于本文件。

API：应用编程接口（ApplicationProgrammingInterface）

ID：标识符（Identifier）

IP：互联网协议（InternetProtocol）

5基本原则

5.1合规性

建立合规监督机制，定期开展合规审查活动，确保智能合约API的技术逻辑符合区块链行业监管要

求，业务逻辑符合数据流通行业监管要求,实现交易可审计。

5.2安全性

1

T/GZBDXXX—XXXX

建立安全审计机制，定期开展安全审计活动，确保智能合约API的数据安全和个人隐私安全，防止

数据泄露。

5.3兼容性

支持多种主流的数据传输协议，确保跨链兼容和多平台适配。

5.4可扩展性

采取模块化设计，支持横向扩展和动态升级。

6接口参数

6.1数据采集参数

6.1.1存证接口

请求参数应符合表1的规定。

表1数据采集存证接口请求参数

参数类型参数名称数据类型约束条件说明

headeraccessToken字符串必选访问令牌

bodyid字符串必选数据资源唯一标识符

createdTime字符串必选首次生成数据时间，格式：yyyy-MM-dd

updateTime字符串必选最新生成数据时间，格式：yyyy-MM-dd

collector字符串必选采集方唯一标识符

source字符串可选采集设备ID、IP地址、传感器编号等

uploadKey字符串可选存证方公钥

blockchainAddress字符串可选区块链地址

fileHash字符串可选标准文件哈希值

返回参数应符合表2的规定。

表2数据采集存证接口返回参数

参数名称数据类型说明

id字符串数据资源唯一标识符

t