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