实施步骤
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 |
报告⽣成中 |