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