实施步骤
API调用示例(1116-企业基本信息)
客户在购买API后,可选择所购买的API接口进行相关调校工作。具体接口信息可在网址:https://open.tianyancha.com/api_list 获取
因为天眼查商业查询的216个接口,对接操作方式相同,因此下面以API“1116-企业基本信息”为例,做使用调测说明。
获取API基本信息
基本信息:
是否需要授权
是,需要添加请求header
HttpGet get = new HttpGet(url); get.setHeader("Authorization", token);
根据代码示例修改获取方式
/** * @param path 对⽅或第三⽅提供的路径 * @param token * @return */ public static String getMessageByUrlToken(String path,String token){ String result=""; try { // 根据地址获取请求 HttpGet request = new HttpGet(path);//这⾥发送get请求 // 获取当前客户端对象 request.setHeader("Authorization", token); HttpClient httpClient = new DefaultHttpClient(); // 通过请求对象获取响应对象 HttpResponse response = httpClient.execute(request); // 判断网络连接状态码是否正常(0--200都数正常) if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) { result= EntityUtils.toString(response.getEntity(),"utf-8"); } } catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); e.printStackTrace(); } return result; } // 访问授权限制访问级别:普通接⼝
请求参数
参数 |
必选 |
类型及范围 |
说明 |
---|---|---|---|
keyword |
true |
String |
搜索关键字(公司名称、公司id、注册号或社会统⼀信⽤代码) |
请求参数需要URLEncode。
返回结果校验
JSON示例
{ “result”: { "historyNames" : “贵州力源液压股份有限公司;”, "cancelDate" null, "regStatus" : “存续”, "regCapital" : “77800.32万人民币”, "city" : “毕节市”, "staffNumRange" : “5000-9999人”, "bondNum" : “600765”, "historyNameList" : [“贵州力源液压股份有限公司”], "industry" : “汽车制造业”, "bondName" : “中航重机”, "revokeDate" : null, "type" : 1, "updateTimes" : 1620622963000, "legalPersonName" : “姬苏春”, "revokeReason" : “”, "regNumber" : “520000000005018”, "creditCode" : “91520000214434146R”, "property3" : “AVIC Heavy Machinery Co.,Ltd.”, "usedBondName" : “力源液压->G力源->力源液压”, "approvedTime" : 1582646400000, "fromTime" : 847900800000, "socialStaffNum" : 9023, "actualCapitalCurrency" : “人民币”, "alias" : “中航重机”, "company0rgType" : “其他股份有限公司(上市)”, "id" : 11684584, "cancelReason" : “”, "orgNumber" : “214434146”, "toTime" : null, "actualCapital" : “77800.32万人民币”, "estiblishTime" : 847900800000, "regInstitute" : “贵阳市市场监督管理局贵州双龙航空港经济区分局”, "businessScope" : “法律、法规、国务院决定规定禁止的不得经营;”, "taxNumber" : “91520000214434146R”, "regCapitalCurrency" : “人民币”, "tags" : “企业集团;存续;融资轮次;上市信息;项目品牌;投资机构;曾用名”, "district" : “威宁彝族回族苗族自治县”, "bondType" : “A股”, "name" : “中航重机股份有限公司”, "percentileScore" : 9696, "industryAll" : { "categoryMiddle" : “改装汽车制造”, "categoryBig" : “汽车制造”, "category" : “制造业”, "categorySmall" : “” }, "isMicroEnt" : 0, "base" : “gz”, }, “reason”: “ok”, “reason”: 0 }
关于错误返回值与错误代码,参⻅错误代码说明
返回字段说明
根据返回字段进行调校。
返回值字段 |
字段类型 |
字段说明 |
备注 |
---|---|---|---|
result |
Object |
- |
- |
historyNames |
String |
varchar(255) |
曾⽤名 |
regStatus |
String |
varchar(31) |
企业状态 |
cancelDate |
Number |
时间戳 |
注销⽇期 |
regCapital |
String |
varchar(50) |
注册资本 |
city |
String |
varchar(20) |
市 |
staffNumRange |
String |
varchar(200) |
⼈员规模 |
industry |
String |
varchar(255) |
⾏业 |
historyNameList |
Array |
- |
曾⽤名 |
bondNum |
String |
varchar(20) |
股票号 |
type |
Number |
int(1) |
法⼈类型,1 ⼈ 2 公司 |
bondName |
String |
varchar(20) |
股票名 |
updateTimes |
Number |
时间戳 |
更新时间 |
revokeDate |
Number |
时间戳 |
吊销⽇期 |
legalPersonName |
String |
varchar(255) |
法⼈ |
revokeReason |
String |
varchar(500) |
吊销原因 |
regNumber |
String |
varchar(31) |
注册号 |
property3 |
String |
varchar(255) |
英⽂名 |
creditCode |
String |
varchar(255) |
统⼀社会信⽤代码 |
usedBondName |
String |
varchar(20) |
股票曾⽤名 |
fromTime |
Number |
时间戳 |
经营开始时间 |
approvedTime |
Number |
时间戳 |
核准时间 |
socialStaffNum |
Number |
int(10) |
参保⼈数 |
alias |
String |
varchar(255) |
简称 |
companyOrgType |
String |
varchar(127) |
企业类型 |
actualCapitalCurrency |
String |
varchar(10) |
实收注册资本币种 ⼈⺠币 美元 欧元 等 |
id |
Number |
int(20) |
企业id |
orgNumber |
String |
varchar(31) |
组织机构代码 |
cancelReason |
String |
varchar(500) |
注销原因 |
toTime |
Number |
时间戳 |
经营结束时间 |
actualCapital |
String |
varchar(50) |
实收注册资⾦ |
estiblishTime |
Number |
时间戳 |
成⽴⽇期 |
regInstitute |
String |
varchar(255) |
登记机关 |
taxNumber |
String |
varchar(255) |
纳税⼈识别号 |
businessScope |
String |
varchar(4091) |
经营范围 |
regLocation |
String |
varchar(255) |
注册地址 |
regCapitalCurrency |
String |
varchar(10) |
注册资本币种 ⼈⺠币 美元 欧元 等 |
tags |
String |
varchar(255) |
企业标签 |
district |
String |
varchar(20) |
区 |
name |
String |
varchar(255) |
企业名 |
bondType |
String |
varchar(31) |
股票类型 |
percentileScore |
Number |
万分制 |
企业评分 |
industryAll |
Object |
- |
国⺠经济⾏业分类 |
categoryMiddle |
String |
varchar(255) |
国⺠经济⾏业分类中类 |
categoryBig |
String |
varchar(255) |
国⺠经济⾏业分类⼤类 |
category |
String |
varchar(255) |
国⺠经济⾏业分类⻔类 |
categorySmall |
String |
varchar(255) |
国⺠经济⾏业分类⼩类 |
isMicroEnt |
Number |
int(1) |
是否是⼩微企业 0不是 1是 |
base |
String |
varchar(31) |
省份简称 |
reason |
String |
- |
错误信息 |
error_code |
Number |
- |
状态码 |
错误代码说明
代码 |
说明 |
---|---|
0 |
请求成功 |
300000 |
⽆数据 |
300001 |
请求失败 |
300002 |
账号失效 |
300003 |
账号过期 |
300004 |
访问频率过快 |
300005 |
⽆权限访问此api |
300006 |
余额不⾜ |
300007 |
剩余次数不⾜ |
300008 |
缺少必要参数 |
300009 |
账号信息有误 |
300010 |
URL不存在 |
300011 |
此IP⽆权限访问此api |
300012 |
报告⽣成中 |