《重点涉海企业直报系统接口指南》（报批稿）.docx

《《重点涉海企业直报系统接口指南》（报批稿）.docx》由会员分享，可在线阅读，更多相关《《重点涉海企业直报系统接口指南》（报批稿）.docx（34页珍藏版）》请在第一文库网上搜索。

1、ICS 07.060CCS A 45HY中 华 人 民 共 和 国 海 洋 行 业 标 准HY/T XXX-202X重点涉海企业直报系统接口指南Interface guidelines for the direct reporting system of key marine-related enterprises（报批稿）（2022 年 8 月 10 日）202X-XX- XX 发布202X-XX-XX 实施中华人民共和国自然资源部 发 布XX/TXXXXXXXXX目 次前言 II1 范围 12 规范性引用文件 13 术语和定义 14 接口功能及流程 14.1 获取服务器公钥 14.2 数据

2、包传输 25 接口规范 45.1 接口通信方式 45.2 传输协议 45.3 数据格式 45.4 接口响应状态 46 接口方法与报文协议 46.1 接口方法 46.2 报文结构 4附 录 A （资料性） 客户端请求报文格式及示例 7附 录 B （资料性） 客户端响应报文格式及示例 12附 录 C （资料性） 数据编码 13参考文献 18IXX/TXXXXXXXXX前 言本文件按照 GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定 起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中华人民共和国自然资源部提出。本文件由全国

3、海洋标准化技术委员会（SAC/TC283）归口。本文件起草单位：国家海洋信息中心。本文件主要起草人： 付瑞全、路文海、段晓峰、郭越、宋维玲、赵龙飞、王园君、赵心宇、李长 如、郑莉、张建辉、左国成。IIXX/TXXXXXXXXX重点涉海企业直报系统接口指南1 范围本文件给出了国家重点涉海企业直报系统（以下简称“国家系统”）的接口功能及流程、接口规 范、接口方法及报文协议等内容。本文件适用于国家级与省市级系统间涉海企业数据的交换和共享。2 规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文 件，仅该日期对应的版本适用于本文件； 不注日期的引用文件，其

4、最新版本（包括所有的修改单）适 用于本文件。GB/T 20794-2021 海洋及相关产业分类HY/T 131 海洋信息化常用术语3 术语和定义GB/T 20794-2021、HY/T 131规定的以及下列术语和定义适用于本文件。3.1海洋经济 ocean economy开发、利用和保护海洋的各类产业活动， 以及与之相关联活动的总和。来源：GB/T 20794-2021，3.13.2涉海企业 marine-related enterprises在市场监督管理部门登记注册的，从事海洋经济活动的企业。3.3重点涉海企业直报系统 direct reporting system of key mari

5、ne-related enterprises依据海洋经济统计调查制度，涉海企业通过网络直接将电子报表报送到海洋经济统计部门的网络 报送系统。4 接口功能及流程4.1 获取服务器公钥4.1.1 接口功能1服务端公钥XX/TXXXXXXXXX省市级系统调用国家系统接口， 获取基于非对称加密算法的服务器公钥，用于后续加密数据包。 注： 数据包中包含用户信息、涉海企业信息和各类报表数据。4.1.2 接口流程省市级系统调用国家系统接口获取服务器公钥流程见图1所示。开始调用国家系统接口图 1 调用国家系统接口获取服务器公钥流程图4.2 数据包传输4.2.1 接口功能省市级系统利用获取的服务器公钥，对数据包

6、进行加密后，调用国家系统传输接口完成信息报送， 并返回报送情况回执信息。4.2.2 接口流程省市级系统对数据包加密及传输详细流程见图2所示，省市级系统报送节点具体流程步骤包括：a) 组合本用户在国家系统内的用户名、密码和注册的 IP 地址等信息，形成报文头，组合待上报 的报表数据形成报文体， 将报文头和报文体拼接后放置待上报数据包中；b) 利用服务器公钥对数据包进行加密；c) 利用加密算法生成客户端自身密钥对；d) 以加密后的数据和客户端公钥作为参数， 调用国家系统传输接口完成信息传输； e) 省市级系统获取服务器回执信息， 通过客户端私钥解密数据， 读取回执信息。 国家系统节点数据解析处理具

7、体流程步骤包括：a) 通过国家系统服务器私钥解密接收到的数据包；b) 验证用户合法性、企业信息完整性；c) 存储验证通过的数据包至国家系统；d) 通过客户端公钥加密后返回回执信息。2XX/TXXXXXXXXX省市级系统国家系统用户信息报表数据组合成数据包服务器私钥非法用户无效数据服务器公钥接口数据接收接口解密数据包验证用户信息解析数据包信息合法性保存信息客户端公钥 加密回执信息客户端公钥加密数据包客户端私钥获取回执信息解密并读取 回执信息结束图 2 省市级系统的数据包加密及传输流程图3XX/TXXXXXXXXX5 接口规范5.1 接口通信方式接口采用同步应答方式， 省市级系统发送数据传输请求后

8、，国家系统同步返回处理结果。5.2 传输协议国家系统接口采用基于安全套接字层的超文本传送协议（Hypertext Transfer Protocol over Secure Socket Layer ，HTTPS）和双向认证的方式，保障交互双方的有效性和合法性。5.3 数据格式接口请求和响应数据均采用可扩展标记语言（Extensible Markup Language，XML）或轻量级的数 据交换格式（JavaScript Object Notation ，JSON）格式。5.4 接口响应状态接口请求响应状态码见表1。表 1 响应状态码表状态码相关说明000服务调用成功001请求发生异常6 接

9、口方法与报文协议6.1 接口方法接口方法及规定见表 2。表 2 接口方法及规定序号方法原型功能描述1getServerPublicKey(params)获取服务端公钥2transferDataSecurityForXML(params,clientPublicKey)采用 XML 数据格式以加密方法同步数据包3transferDataSecurityForJson(params,clientPublicKey)采用 JSON 数据格式以加密方法同步数据包6.2 报文结构6.2.1 请求报文结构6.2.1.1 XML 格式请求XML格式请求的基本形式见图3所示，具体格式说明参见附录A中表A.1，

10、详细数据编码参见附录C。4XX/TXXXXXXXXX图 3 XML 格式请求的基本形式6.2.1.2 JSON 格式请求JSON格式请求的基本形式见图4所示，具体格式说明参见附录表A.2，详细数据编码参见附录C，详 细示例参见图A.1图A.2。图 4 JSON 格式请求的基本形式6.2.2 响应报文结构6.2.2.1 XML 格式响应XML格式响应的基本形式见图5所示，具体内容参见附录B中表B.1。5XX/TXXXXXXXXX图 5 XML 格式响应的基本形式6.2.2.2 JSON 格式响应JSON格式响应的基本形式见图6所示，具体内容参见附录表B.2，详细示例参见附录图B.1。图 6 JS

11、ON 格式响应的基本形式6XX/TXXXXXXXXX附 录 A（资料性）客户端请求报文格式及示例表A.1表A.2给出了客户端请求报文的具体格式说明，图A.1图A.2给出了客户端请求JSON格式 报文示例说明。表 A.1 请求信息 XML 格式数据项标识数据项描述父节点标识excuteXML报文根节点identity整个传输过程中的标识excuteXMLserviceId业务服务标识，参照附录表 C.1identityuserName身份验证用户名identitytimeStamp时间戳identitypassword身份验证密码，经过加密identityoperateType操作类型，1:新增

12、修改 0:删除identitybusinessContent业务体内容excuteXMLreport报表项businessContentreportNo报表名称编码，参照附录表 C.2reportregionCode企业所在地行政区划代码，参照 HY/T 094 执行reportunitCode填报单位代码reportreportYear报表年份reportseqYear报表在年度中的序号reportfrequency频度，参照附录表 C.3reportreportStatus报表审核状态，1:通过 0：驳回reportcontactPerson单位负责人reportuserStatAdmin

13、统计负责人reportuserStat填表人reportrows数据行reportrowIndex行序号从 0 开始rowindicator指标数据项rowindicatorNo指标编码，参照附录表 C.4indicatorindicatorMeaSure计量单位编码，参照附录表 C.5indicatortype指标属性类型indicatorindicatorType数据类型编码，参照附录表 C.6typeindicatorValue指标值type7XX/TXXXXXXXXX表 A.1 请求信息 XML 格式（续）数据项标识数据项描述父节点标识unitList企业信息集合项businessContentunit企业信息项unitListunitCode统一社会信用代码/组织机构代码unituni