DB13∕T 2709-2018 法人和其他组织统一社会信用代码证数据库访问服务接口技术规范(河北省).pdf
《DB13∕T 2709-2018 法人和其他组织统一社会信用代码证数据库访问服务接口技术规范(河北省).pdf》由会员分享,可在线阅读,更多相关《DB13∕T 2709-2018 法人和其他组织统一社会信用代码证数据库访问服务接口技术规范(河北省).pdf(14页珍藏版)》请在咨信网上搜索。
1、ICS 03.100.01 A 02 DB13 河北省地方标准 DB 13/T 27092018 法人和其他组织统一社会信用代码数据库访问服务接口技术规范 2018- 04 - 09 发布 2018 - 05 - 09 实施 河北省质量技术监督局 发 布 DB13/T 27092018 I 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由河北省质量技术监督局提出。 本标准由河北省服务标准化技术委员会(SAHB/TC 264)归口。 本标准起草单位:河北省标准化研究院、石家庄宇邦软件科技有限公司。 本标准起草人:阎占辉、董世涛、李虓峰、高龙、于潇、闫志强、李英君、孙明立、李
2、会、孙家田。DB13/T 27092018 1 法人和其他组织统一社会信用代码数据库 访问服务接口技术规范 1 范围 本标准规定了法人和其他组织统一社会信用代码数据库访问服务接口(以下简称统一代码接口)的术语、定义和缩略语、统一代码接口框架、统一代码接口要求、统一代码接口服务数据项和统一代码接口调用状态信息。 本标准适用于政府部门以接口方式进行的统一社会信用代码数据库信息共享应用。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 2260 中华人民共和国行
3、政区划代码 GB/T 4754 国民经济行业分类 GB 32100 法人和其他组织统一社会信用代码编码规则 3 术语、定义和缩略语 3.1 术语和定义 下列术语和定义适用于本文件。 3.1.1 接口 interface 体现一个实体行为特征的具体名称的操作集。 3.1.2 请求 request 接口用户向接口发出的一次调用申请。 3.1.3 响应 response 接口向接口用户返回请求的操作结果。 3.1.4 包体 entity-body 数据传输中的实体主体部分。 3.2 缩略语 下列缩略语适用于本文件。 DB13/T 27092018 2 HTTPS 基于安全套接字的超文本传输协议(Se
4、cure hypertext transfer protocol) XML 可扩展标识语言(Extensible markup language) JSON JS对象标记(JavaScript object notation) 4 统一代码接口框架 4.1 许可和调用 4.1.1 接口用户向接口提供方提交使用申请,用户申请信息包括: a) 机构统一社会信用代码; b) 机构名称; c) 用于实现应用接口功能的设备的 IP 地址; d) 申请使用期限; e) 申请使用数据项。 4.1.2 接口提供方收到申请后,生成许可信息反馈给接口用户,许可信息包括: a) 机构统一社会信用代码; b) 机构名
5、称; c) 用于实现应用接口功能的设备的 IP 地址; d) 申请使用期限; e) 用户账号; f) 用户密码; g) 接口地址。 4.1.3 接口用户在调用接口时,应提供被授予的许可信息。 4.1.4 接口在接收到请求后,校验接口用户许可信息中用于实现应用接口功能的设备的 IP 地址和申请使用期限的有效性、用户账号和用户密码的合法性,检验通过后,执行请求,返回响应内容。 4.2 应用模型 统一代码接口应用模型见图1。 图 1 统一代码接口应用模型 接口用户 接口 请求 响应 DB13/T 27092018 3 5 统一代码接口要求 5.1 接口定义 统一代码接口定义见表1。 表 1 统一代码
6、接口定义 定义 说明 String Tydm_sh_service (string licence, string cond_information, string repl_packagetype) 1. Tydm_sh_service 为约定的接口名称。 2. license 为许可参数(见 5.3)。 3. cond_information 为条件参数(见 5.4)。 4. repl_packagetype 为返回结果数据包格式参数(见 5.5)。 5. 接口返回结果见 5.6。 5.2 基本约定 5.2.1 传输协议 采用HTTPS作为传输协议。 5.2.2 地址格式 接口地址由接口提
7、供方提供, 格式为: https:/xxx.xxx.xxx.xxx/services_path/service_name。 其中: xxx.xxx.xxx.xxx表示接口所在的服务器的有效地址; services_path表示接口的发布路径,由接口提供方命名;service_name表示约定的接口名称,由接口提供方命名。 5.2.3 安全性 接口用户以接口提供方授权的许可为凭据调用接口。 5.2.4 调用方法 统一代码接口调用方法实例参见附录A。 5.3 许可参数 5.3.1 内容组成 许可参数由一组用户信息组成。 5.3.2 包体标记及含义 许可参数包体标记及含义说明见表2。 DB13/T
8、27092018 4 表 2 许可参数包体标记及含义 信息类别 标记 字符类型及长度 含义 说明 用户信息 tydm nvarchar(18) 机构统一社会信用代码 - jgmc nvarchar(400) 机构名称 - appkey nvarchar(8) 用户账号 - appsecret nvarchar(10) 用户密码 - ip nvarchar(15) 被授权应用接口的设备的 IP 地址 - startdate nvarchar(10) 使用期限开始时间 授权起始日期 enddate nvarchar(10) 使用期限结束时间 授权终止日期 5.3.3 包体格式说明 许可参数包体采用
9、JSON格式。 许可参数放置在标记之间,见示例1。 示例1: tydm: xxxxxxxxxxxxxxxx, jgmc: xxx, appkey:xxx, appsecret:xxx, ip: xxx, startdate: xxx, enddate:xxx 5.4 条件参数 5.4.1 内容组成 条件参数由条件逻辑关系、条件数据项集、返回结果数据项名称组成。见图2。 图 2 条件参数 5.4.2 包体格式说明 条件参数包体采用JSON格式。 条件数据项集 条件逻辑关系 返回结果数据项名称 条件数据项 1 条件数据项 n DB13/T 27092018 5 条 件 参 数 放 置 在 标 记
10、exp:xxx,fields:field:xxx, operation:xxx, value:xxx, field:xxx, operation:xxx, value:xxx, result:xxx之间。 exp关键字为条件逻辑关系。其中与、或分别用*、+标识;为空时,默认为与;在逻辑关系中,第一个条件数据项用0表示,第二个用1表示,以此类推,第n个用n-1表示,各条件之间可以用圆括号运算符()组合。 fields关键字为条件数据项集。其中field关键字为条件数据项;operation为条件数据项的关系运算符,其表示及含义见表3;value为条件数据项的值。 result关键字为返回结果中用
11、户要求的数据项名称,各数据项间以“,”分隔。 数据项标识应符合本标准第6章的规定。 表 3 关系运算符表示及含义 关系运算符 含义 说明 = 等于 字符型按字符编码顺序进行比较 数值型应转换成数值进行比较 日期型应转换成日期进行比较 日期时间型应转换成时间进行比较 大于 = 大于或等于 不等于 like 模糊匹配 仅可应用于字符型的数据项,从字符串任意位置进行匹配 left like 左匹配 仅可应用于字符型的数据项,从字符串起始端匹配 right like 右匹配 仅可应用于字符型的数据项,从字符串尾端匹配 is null 空值 - is not null 非空 - 条件参数包体格式见示例2
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB13T 2709-2018 法人和其他组织统一社会信用代码证数据库访问服务接口技术规范河北省 DB13 2709 2018 法人 其他 组织 统一 社会 信用 代码证 数据库 访问 服务 接口
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。
链接地址:https://www.zixin.com.cn/doc/164130.html