简单易集成的企业工商信息查询API开发文档

小太阳

一、接口简介

1、版权说明：

未经翔云人工智能开放平台授权，不得擅自进行使用。

2、调用客户端运行环境

当客户端使用的编程语言为Java时，请使用1.5及以上版本JRE。

3、服务主要功能描述

翔云企业工商信息查询标准版服务，实时联网权威数据源，通过企业（个体）名称查询企业（个体）信息，当天注册信息，次日可查。返回的字段包含企业及个体营业执照照面信息、经营状态等，数据覆盖全国。

1) 通过https协议post方法上传；

2) 将核验结果以XML或json格式返回给用户；

4、服务调用约束

企业工商信息查询标准版接口前，请您确保客户端程序或设备网络连接通畅。

二、前提准备

1、用户登录 https://www.netocr.com/register.html注册账号，如图:

2、输入注册信息，确认无误后点击同意条款并注册，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps11.jpg

3、注册成功后点击右上角的账号名称-个人中心，进入管理页面:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps12.jpg

4、点击“用户管理-基础信息”，查看OCRKey以及OCRSecret：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps13.jpg

5、点击“服务列表”，查看服务次数及余额(每调用一次https接口消耗一次)，可点击立即购买直接跳转到购买页面购买API服务次数：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps14.jpg

6、购买成功后,会显示购买的总次数及剩余次数，例如下图所示：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps15.jpg

7、设置剩余条数提醒，进入个人中心-用户管理-剩余条数提醒，设置提醒下线、通知手机号及服务类型，设置成功后到达用户设置的服务剩余条数下限，系统会发短息至预留手机号。

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps16.jpg

三、接口说明

接口地址：https://netocr.com/verapi/verLicence.do

接口调用方法：post

3、请求参数

接口接收参数：
序号	名称		类型	必填		说明
1	key		String	是		用户ocrKey
2	secret		String	是		用户ocrSecrert
3	entName		String	是		企业或个体名称（utf-8格式base64加密）
4	typeId		Integer	是		企业或个体工商信息查询：3014
5	format		String	是		返回格式(xml或者json)，如果format为空，则默认返回xml
状态码说明：
status		code			message
		2			调用成功
		0010040001			传入前参数格式错误
		0010040002			数据参数格式错误
		0010040003			输入参数为空
		0010040004			输入参数非法
		0010090100			未知异常
		其他			请联系客服

调用错误码

status值	描述
-1	用户已屏蔽
-2	用户key或secret验证错误
-3	服务次数不足
-4	用户未找到
-6	系统异常
-7	图片不可为空，参数不可为空
-8	类型错误

调用方式(java客户端基于httpclient4.3)
1.依赖库: \java客户端\httpClient4.3库\，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps17.png

2.示例程序代码详见: \java客户端\httpClientDemo\中的Client类，如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps18.png

在main方法定义参数，并传入   doPost(url, file, key, secret, typeId, format) 方法中。如图:

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps19.png

返回结果如下：

file:///C:/Users/user/AppData/Local/Temp/ksohtml10256/wps20.jpg

剩余条数查询接口(所有产品类型)

接口地址：	https://netocr.com/api/accountLift.do
接口调用方法：	post
接口接收参数：
String key：	用户ocrKey
String secret：	用户ocrSecret
String format：	返回格式(xml或者json)，如果format为空，则默认返回xml

技术支持

电话：     010－87422432/2430         杨工/田工/李工