基本信息
接口地址
https://api.qixin.com/APIService/reports/getReportListByName数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/reports/getReportListByName?keyword=湖南凯鸿之星汽车贸易有限公司描述
企业工商年报信息
请求参数 (Headers)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
Auth-Version |
String | 是 | 2.0(参数值),固定传入:2.0 |
appkey |
String | 是 | 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单” |
timestamp |
String | 是 | UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效 |
sign |
String | 是 | 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’) |
请求参数 (Query)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
keyword |
String | 是 | 企业全名/注册号/统一社会信用代码 |
响应参数
| 参数名 | 类型 | 长度 | 描述 |
|---|---|---|---|
datadata.data |
Object | 0 | 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表 |
totaldata.data.total |
Number | 0 | 返回列表中记录总数 |
itemsdata.data.items |
Array | 0 | 企业年报信息列表 |
report_namedata.data.items.report_name |
String | 255 | 年报名称 |
female_collegues_numdata.data.items.female_collegues_num |
String | 255 | 女性从业人数 |
enterprise_holding_situationdata.data.items.enterprise_holding_situation |
String | 255 | 企业控股情况 |
sup_enamedata.data.items.sup_ename |
String | 255 | 隶属企业名称 |
sup_credit_nodata.data.items.sup_credit_no |
String | 255 | 隶属企业统一社会信用代码或注册号 |
sup_eiddata.data.items.sup_eid |
String | 36 | 隶属企业ID |
if_websitedata.data.items.if_website |
String | 255 | 是否有网站或网店 |
sale_incomedata.data.items.sale_income |
String | 255 | 营业总收入 |
reg_nodata.data.items.reg_no |
String | 255 | 注册号 |
emaildata.data.items.email |
String | 255 | 电子邮箱 |
addressdata.data.items.address |
String | 255 | 企业通信地址 |
guarantee_itemsdata.data.items.guarantee_items |
Array | 0 | 债务信息 |
creditordata.data.items.guarantee_items.creditor |
String | 255 | 债权人 |
debitordata.data.items.guarantee_items.debitor |
String | 255 | 债务人 |
debit_typedata.data.items.guarantee_items.debit_type |
String | 255 | 主债权种类 |
debit_amountdata.data.items.guarantee_items.debit_amount |
String | 255 | 主债权数额 |
debit_perioddata.data.items.guarantee_items.debit_period |
String | 255 | 履行债务的期限 |
guarant_methoddata.data.items.guarantee_items.guarant_method |
String | 255 | 保证的方式 |
guarant_perioddata.data.items.guarantee_items.guarant_period |
String | 255 | 保证的期间 |
guarant_scopedata.data.items.guarantee_items.guarant_scope |
String | 255 | 保证担保的范围 |
fare_scopedata.data.items.fare_scope |
String | 6000 | 主营业务 |
total_equitydata.data.items.total_equity |
String | 255 | 资产总额 |
tax_totaldata.data.items.tax_total |
String | 255 | 纳税总额 |
namedata.data.items.name |
String | 255 | 企业名称 |
if_external_guaranteedata.data.items.if_external_guarantee |
String | 255 | 是否提供对外担保 |
partnersdata.data.items.partners |
Array | 0 | 股东信息 |
identify_typedata.data.items.partners.identify_type |
String | 255 | 证件类型 |
should_capi_itemsdata.data.items.partners.should_capi_items |
Array | 0 | 应缴出资信息 |
should_capi_datedata.data.items.partners.should_capi_items.should_capi_date |
String | 255 | 认缴出资时间 |
shoud_capidata.data.items.partners.should_capi_items.shoud_capi |
String | 255 | 认缴出资额 |
invest_typedata.data.items.partners.should_capi_items.invest_type |
String | 255 | 认缴出资方式 |
stock_typedata.data.items.partners.stock_type |
String | 255 | 股东类型 |
real_capi_itemsdata.data.items.partners.real_capi_items |
Array | 0 | 实缴出资信息 |
real_capidata.data.items.partners.real_capi_items.real_capi |
String | 255 | 实缴出资额 |
invest_typedata.data.items.partners.real_capi_items.invest_type |
String | 255 | 实缴出资方式 |
real_capi_datedata.data.items.partners.real_capi_items.real_capi_date |
String | 255 | 实缴出资时间 |
stock_namedata.data.items.partners.stock_name |
String | 255 | 股东名称 |
identify_nodata.data.items.partners.identify_no |
String | 255 | 企业证照号 |
stock_percentdata.data.items.partners.stock_percent |
String | 255 | 股东所占比例(目前工商无数据,不返回) |
oper_namedata.data.items.oper_name |
String | 255 | 企业法定代表人 |
telephonedata.data.items.telephone |
String | 255 | 企业联系电话 |
statusdata.data.items.status |
String | 255 | 企业标准经营状态(已废弃) |
profit_retadata.data.items.profit_reta |
String | 255 | 所有者权益合计 |
zip_codedata.data.items.zip_code |
String | 255 | 邮政编码 |
prac_person_numdata.data.items.prac_person_num |
String | 255 | 实际员工数量 |
profit_totaldata.data.items.profit_total |
String | 255 | 利润总额 |
reg_capidata.data.items.reg_capi |
String | 255 | 注册资本 |
if_investdata.data.items.if_invest |
String | 255 | 企业是否有投资信息或购买其他公司股权 |
report_datedata.data.items.report_date |
String | 255 | 发布日期 |
websitesdata.data.items.websites |
Array | 0 | 网站信息 |
web_typedata.data.items.websites.web_type |
String | 255 | 网站类型 |
web_namedata.data.items.websites.web_name |
String | 255 | 网站名称 |
web_urldata.data.items.websites.web_url |
String | 255 | 网站网址 |
serv_fare_incomedata.data.items.serv_fare_income |
String | 255 | 主营业务收入 |
stock_changesdata.data.items.stock_changes |
Array | 0 | 股权变更信息 |
namedata.data.items.stock_changes.name |
String | 255 | 股东 |
before_percentdata.data.items.stock_changes.before_percent |
String | 255 | 变更前股权比例 |
after_percentdata.data.items.stock_changes.after_percent |
String | 255 | 变更后股权比例 |
public_datedata.data.items.stock_changes.public_date |
String | 255 | 发布日期 |
change_datedata.data.items.stock_changes.change_date |
String | 255 | 股权变更日期 |
if_equitydata.data.items.if_equity |
String | 255 | 有限责任公司本年度是否发生股东股权转 |
report_yeardata.data.items.report_year |
String | 255 | 年报年份 |
credit_nodata.data.items.credit_no |
String | 255 | 统一社会信用代码 |
collegues_numdata.data.items.collegues_num |
String | 255 | 从业人数 |
origin_statusdata.data.items.origin_status |
String | 255 | 企业经营状态 |
net_amountdata.data.items.net_amount |
String | 255 | 净利润 |
invest_itemsdata.data.items.invest_items |
Array | 0 | 对外投资信息 |
invest_namedata.data.items.invest_items.invest_name |
String | 255 | 对外投资企业名称 |
invest_reg_nodata.data.items.invest_items.invest_reg_no |
String | 255 | 对外投资企业注册号 |
invest_capidata.data.items.invest_items.invest_capi |
String | 255 | 对外投资金额 |
invest_percentdata.data.items.invest_items.invest_percent |
String | 255 | 对外投资比例 |
debit_amountdata.data.items.debit_amount |
String | 255 | 负债总额 |
signdata.sign |
String | 32 | 数据签名 |
statusdata.status |
String | 0 | 返回结果状态 |
messagedata.message |
String | 255 | 返回结果消息 |
响应示例
JSON
{
"status": "200",
"message": "操作成功",
"sign": "59727696d160ef89aac666b44f673a1d",
"data": {
"total": 2,
"items": [
{
"report_year": "2018",
"report_date": "2019-02-15",
"name": "湖南凯鸿之星汽车贸易有限公司",
"reg_no": "430102000378276",
"credit_no": "91430102MA4LN7C8XF",
"telephone": "13786180581",
"email": "490731987@qq.com",
"address": "湖南省长沙市芙蓉区马王堆街道滩头坪路288号万象凯旋湾家园1栋2406房",
"oper_name": "-",
"zip_code": "410000",
"reg_capi": "-",
"if_invest": "否",
"if_website": "否",
"if_equity": "否",
"if_external_guarantee": "否",
"collegues_num": "企业选择不公示",
"status": "在业",
"origin_status": "开业",
"sale_income": "企业选择不公示",
"debit_amount": "企业选择不公示",
"net_amount": "企业选择不公示",
"prac_person_num": "-",
"profit_reta": "企业选择不公示",
"profit_total": "企业选择不公示",
"tax_total": "企业选择不公示",
"total_equity": "企业选择不公示",
"fare_scope": "-",
"serv_fare_income": "企业选择不公示",
"websites": [],
"stock_changes": [],
"invest_items": [],
"partners": [
{
"stock_name": "刘欣",
"stock_type": "-",
"stock_percent": "-",
"identify_type": "-",
"identify_no": "-",
"should_capi_items": [
{
"shoud_capi": "200万人民币",
"should_capi_date": "2046-06-02",
"invest_type": "货币"
}
],
"real_capi_items": []
}
],
"guarantee_items": []
},
{
"report_year": "2017",
"report_date": "2018-05-04",
"name": "湖南凯鸿之星汽车贸易有限公司",
"reg_no": "430102000378276",
"credit_no": "91430102MA4LN7C8XF",
"telephone": "13627138088",
"email": "无",
"address": "湖南省长沙市芙蓉区马王堆街道滩头坪路288号万象凯旋湾家园1栋2406房",
"oper_name": "-",
"zip_code": "410000",
"reg_capi": "-",
"if_invest": "否",
"if_website": "否",
"if_equity": "否",
"if_external_guarantee": "否",
"collegues_num": "企业选择不公示",
"status": "在业",
"origin_status": "开业",
"sale_income": "企业选择不公示",
"debit_amount": "企业选择不公示",
"net_amount": "企业选择不公示",
"prac_person_num": "-",
"profit_reta": "企业选择不公示",
"profit_total": "企业选择不公示",
"tax_total": "企业选择不公示",
"total_equity": "企业选择不公示",
"fare_scope": "-",
"serv_fare_income": "企业选择不公示",
"websites": [],
"stock_changes": [],
"invest_items": [],
"partners": [
{
"stock_name": "刘欣",
"stock_type": "-",
"stock_percent": "-",
"identify_type": "-",
"identify_no": "-",
"should_capi_items": [
{
"shoud_capi": "200万人民币",
"should_capi_date": "2067-05-14",
"invest_type": "货币"
}
],
"real_capi_items": []
}
],
"guarantee_items": []
}
]
}
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');
let baseUrl = 'https://api.qixin.com/APIService/reports/getReportListByName';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');
let urlParams = {
keyword: 'keyword的值'
}
let concatParams = []
for (let key in urlParams) {
concatParams.push(key + '=' + urlParams[key]);
}
let options = {
'method': 'GET',
'url': baseUrl + '?' + concatParams.join('&'),
'headers': {
'Connection': 'keep-alive',
'Auth-version': '2.0',
'appkey': appkey,
'timestamp': timeStamp,
'sign': sign
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
文档下载
3.1-工商年报.pdf
PDF接口文档