工商网监标识业务对接接口.docx

工商网监标识业务对接接口说明文件状态： 草稿 正式发布 正在修改文件标识：当前版本：1.0作者：王群眺完成日期：2016-05-30 版本历史 版本/状态作者参与者起止日期备注1.0王群眺2015-05-30创建文档 目录工商网监标识业务对接接口说明11. 文档介绍41.1. 文档目的41.2. 术语与缩写介绍42. 开发环境要求42.1. .NET环境43. 接口说明53.1. 接口内容53.2. 接口方法53.2.1. 申领信息推送51. 文档介绍1.1. 文档目的本文档描述平台如何通过服务接口与“工商网监系统”进行数据对接，对平台查询、申领工商网监业务提供了指导说明。1.2. 术语与缩写介绍缩写、术语解释WCF由微软开发的一系列支持数据通信的应用程序框架，整合了原有的windows通讯的 .net Remoting，WebService，Socket的机制，并融合有Http和Ftp的相关技术。是Windows平台上开发分布式应用最佳的实践方式。JsonJSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。它基于ECMAScript的一个子集。SOA面向服务架构，它可以根据需求通过网络对松散耦合的粗粒度应用组件进行分布式部署、组合和使用。服务层是SOA的基础，可以直接被应用调用，从而有效控制系统中与软件代理交互的人为依赖性。2. 开发环境要求2.1. .NET环境开发工具要求.Net Framework4.0 WCF数据通信的应用程序框架3. 接口说明3.1. 接口内容1) 服务地址：/service.svc（测试地址，需设置本地host 97 ）2) 调用方法：ApplyAndGetMarkBy(platformId,applyInfo)，参数说明如下表：参数说明platformIdstring类型，平台id,具体值由工商网监分配applyInfostring类型，json格式表示的参数集合，传入申领的信息表3-1 方法参数说明3.2. 接口方法3.2.1. 申领信息推送1) ApplyAndGetMarkBy方法参数：platformId参数10D5D59F-63AE-458E-B735-D1E6E75C7326（测试）jsonParam参数Json格式内容字段说明Json内容由两部分组成：企业信息以及身份验证信息，其中企业信息为数据对象，可由单条企业信息组成，在Json中使用“EntEntity:”对象表示1CreditCodeNo:0,EntRegNo:4403011000000000,EntOrgCode:0,EntName:某某有限公司,EntNameEn:Company,WebName:测试网站,WebAddress:,ContactName:王生,ContactPhoneContactEmail:/ 以下内容为申请信息2企业工商注册号，企业工商注册号、企业组织机构代码号、企业组织机构代码号三者，其中一个有值即可，其余可为0或空3企业名称4企业英文名称（以企业基本账户开户的英文名称或者深圳贸促委备案的英文名称为准，如果均没有的，才以企业自己规范的英文名称登记）5网站名称，可空6网站地址，必需有，且以http/https开头7企业联系人名称8企业联系人电话9企业联系人邮箱10/申请信息结束表3-2 申请信息参数表 2) ApplyAndGetMarkBy方法返回值：返回值Json格式内容说明12 ResultCode:0, Message:返回代码 0：成功，message存放挂标代码；3：平台不存在；4：传入参数不符要求；5：联系电话错误；6：联系邮箱错误；11：未办理工商注册业务；99：其他错误；3表3-3 ApplyAndGetMarkBy方法返回值表3) 调用示例（以.NET C#代码为例）：行号代码1string applyInfo= CreditCodeNo:0,EntRegNo:4403011000000000,EntOrgCode:0,WebName:null,WebAddress:,ContactName:王生,ContactPhoneContactEmail:;var client = new