API文档 工商信息 工商年报
基本信息
接口地址
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 企业全名/注册号/统一社会信用代码
响应参数
参数名类型长度描述
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表
total
data.data.total
Number 0 返回列表中记录总数
items
data.data.items
Array 0 企业年报信息列表
report_name
data.data.items.report_name
String 255 年报名称
female_collegues_num
data.data.items.female_collegues_num
String 255 女性从业人数
enterprise_holding_situation
data.data.items.enterprise_holding_situation
String 255 企业控股情况
sup_ename
data.data.items.sup_ename
String 255 隶属企业名称
sup_credit_no
data.data.items.sup_credit_no
String 255 隶属企业统一社会信用代码或注册号
sup_eid
data.data.items.sup_eid
String 36 隶属企业ID
if_website
data.data.items.if_website
String 255 是否有网站或网店
sale_income
data.data.items.sale_income
String 255 营业总收入
reg_no
data.data.items.reg_no
String 255 注册号
email
data.data.items.email
String 255 电子邮箱
address
data.data.items.address
String 255 企业通信地址
guarantee_items
data.data.items.guarantee_items
Array 0 债务信息
creditor
data.data.items.guarantee_items.creditor
String 255 债权人
debitor
data.data.items.guarantee_items.debitor
String 255 债务人
debit_type
data.data.items.guarantee_items.debit_type
String 255 主债权种类
debit_amount
data.data.items.guarantee_items.debit_amount
String 255 主债权数额
debit_period
data.data.items.guarantee_items.debit_period
String 255 履行债务的期限
guarant_method
data.data.items.guarantee_items.guarant_method
String 255 保证的方式
guarant_period
data.data.items.guarantee_items.guarant_period
String 255 保证的期间
guarant_scope
data.data.items.guarantee_items.guarant_scope
String 255 保证担保的范围
fare_scope
data.data.items.fare_scope
String 6000 主营业务
total_equity
data.data.items.total_equity
String 255 资产总额
tax_total
data.data.items.tax_total
String 255 纳税总额
name
data.data.items.name
String 255 企业名称
if_external_guarantee
data.data.items.if_external_guarantee
String 255 是否提供对外担保
partners
data.data.items.partners
Array 0 股东信息
identify_type
data.data.items.partners.identify_type
String 255 证件类型
should_capi_items
data.data.items.partners.should_capi_items
Array 0 应缴出资信息
should_capi_date
data.data.items.partners.should_capi_items.should_capi_date
String 255 认缴出资时间
shoud_capi
data.data.items.partners.should_capi_items.shoud_capi
String 255 认缴出资额
invest_type
data.data.items.partners.should_capi_items.invest_type
String 255 认缴出资方式
stock_type
data.data.items.partners.stock_type
String 255 股东类型
real_capi_items
data.data.items.partners.real_capi_items
Array 0 实缴出资信息
real_capi
data.data.items.partners.real_capi_items.real_capi
String 255 实缴出资额
invest_type
data.data.items.partners.real_capi_items.invest_type
String 255 实缴出资方式
real_capi_date
data.data.items.partners.real_capi_items.real_capi_date
String 255 实缴出资时间
stock_name
data.data.items.partners.stock_name
String 255 股东名称
identify_no
data.data.items.partners.identify_no
String 255 企业证照号
stock_percent
data.data.items.partners.stock_percent
String 255 股东所占比例(目前工商无数据,不返回)
oper_name
data.data.items.oper_name
String 255 企业法定代表人
telephone
data.data.items.telephone
String 255 企业联系电话
status
data.data.items.status
String 255 企业标准经营状态(已废弃)
profit_reta
data.data.items.profit_reta
String 255 所有者权益合计
zip_code
data.data.items.zip_code
String 255 邮政编码
prac_person_num
data.data.items.prac_person_num
String 255 实际员工数量
profit_total
data.data.items.profit_total
String 255 利润总额
reg_capi
data.data.items.reg_capi
String 255 注册资本
if_invest
data.data.items.if_invest
String 255 企业是否有投资信息或购买其他公司股权
report_date
data.data.items.report_date
String 255 发布日期
websites
data.data.items.websites
Array 0 网站信息
web_type
data.data.items.websites.web_type
String 255 网站类型
web_name
data.data.items.websites.web_name
String 255 网站名称
web_url
data.data.items.websites.web_url
String 255 网站网址
serv_fare_income
data.data.items.serv_fare_income
String 255 主营业务收入
stock_changes
data.data.items.stock_changes
Array 0 股权变更信息
name
data.data.items.stock_changes.name
String 255 股东
before_percent
data.data.items.stock_changes.before_percent
String 255 变更前股权比例
after_percent
data.data.items.stock_changes.after_percent
String 255 变更后股权比例
public_date
data.data.items.stock_changes.public_date
String 255 发布日期
change_date
data.data.items.stock_changes.change_date
String 255 股权变更日期
if_equity
data.data.items.if_equity
String 255 有限责任公司本年度是否发生股东股权转
report_year
data.data.items.report_year
String 255 年报年份
credit_no
data.data.items.credit_no
String 255 统一社会信用代码
collegues_num
data.data.items.collegues_num
String 255 从业人数
origin_status
data.data.items.origin_status
String 255 企业经营状态
net_amount
data.data.items.net_amount
String 255 净利润
invest_items
data.data.items.invest_items
Array 0 对外投资信息
invest_name
data.data.items.invest_items.invest_name
String 255 对外投资企业名称
invest_reg_no
data.data.items.invest_items.invest_reg_no
String 255 对外投资企业注册号
invest_capi
data.data.items.invest_items.invest_capi
String 255 对外投资金额
invest_percent
data.data.items.invest_items.invest_percent
String 255 对外投资比例
debit_amount
data.data.items.debit_amount
String 255 负债总额
sign
data.sign
String 32 数据签名
status
data.status
String 0 返回结果状态
message
data.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);
});