更新时间:2024-04-23 GMT+08:00
分享

实施步骤

API调用示例(1116-企业基本信息)

客户在购买API后,可选择所购买的API接口进行相关调校工作。具体接口信息可在网址:https://open.tianyancha.com/api_list 获取

图1 获取信息

因为天眼查商业查询的216个接口,对接操作方式相同,因此下面以API“1116-企业基本信息”为例,做使用调测说明。

获取API基本信息

基本信息:

图2 基本信息

是否需要授权

是,需要添加请求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;
}


// 访问授权限制访问级别:普通接⼝

请求参数

表1 请求参数

参数

必选

类型及范围

说明

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
  }

关于错误返回值与错误代码,参⻅错误代码说明

返回字段说明

根据返回字段进行调校。

表2 返回字段说明

返回值字段

字段类型

字段说明

备注

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

-

状态码

错误代码说明

表3 错误代码说明

代码

说明

0

请求成功

300000

⽆数据

300001

请求失败

300002

账号失效

300003

账号过期

300004

访问频率过快

300005

⽆权限访问此api

300006

余额不⾜

300007

剩余次数不⾜

300008

缺少必要参数

300009

账号信息有误

300010

URL不存在

300011

此IP⽆权限访问此api

300012

报告⽣成中

相关文档