通过企业全称或ID，获取和该企业相关的主要人员、股东信息、对外投资、变更记录、企业年报、分支机构等信息【模糊搜索及工商类其它接口可参考： https://api.yonyoucloud.com/apilink/apiweb-static/page/gongshang/】
1.接口介绍
1.1.变更记录
接口名称：变更记录
接口类型：数据获取
接口说明：通过企业全称或ID，获取该企业变更项目、创建时间、变更前、变更后、变更时间等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/changeinfo
请求方式：GET （HTTP请求）
完整URL示例： Url: http://api.yonyoucloud.com/apis/dst/background/changeinfo?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
|
pageNum |
false |
String |
当前页数（默认第一页，每页20条） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文章结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
状态码 |
|
|
reason |
String |
错误信息 |
|
|
result |
Object |
|
|
|
total |
Number |
变更总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
changeItem |
String |
变更事项 |
Varchar（4091） |
|
createTime |
String |
创建时间 |
|
|
contentBefore |
String |
变更前 |
mediumtext |
|
contentAfter |
String |
变更后 |
mediumtext |
|
changeTime |
String |
变更时间 |
|
1.2.企业年报
接口名称：企业年报
接口类型：数据获取
接口说明：通过企业全称或ID，获取和该企业相关的主要人员、股东信息、对外投资、变更记录、企业年报、分支机构等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/annualreport
请求方式：GET （HTTP请求）
完整URL示例： Url: http://api.yonyoucloud.com/apis/dst/background/annualreport?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文档结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
错误码 |
|
|
reason |
String |
错误信息 |
|
|
result |
Object |
|
|
|
total |
Number |
年报总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
baseInfo |
Object |
基本信息 |
|
|
reportYear |
String |
年份 |
varchar(20) |
|
companyName |
String |
公司名 |
varchar(255) |
|
creditCode |
String |
统一社会信用代码 |
varchar(20) |
|
regNumber |
String |
注册码 |
varchar(50) |
|
phoneNumber |
String |
联系方式 |
varchar(50) |
|
postcode |
String |
邮编 |
varchar(20) |
|
postalAddress |
String |
邮编地址 |
varchar(255) |
|
|
String |
邮箱 |
varchar(50) |
|
manageState |
String |
经营状态 |
varchar(20) |
|
employeeNum |
String |
从业人数 |
varchar(200) |
|
operatorName |
String |
经营者名称 |
varchar(50) |
|
totalAssets |
String |
资产总额 |
varchar(50) |
|
totalEquity |
String |
所有者权益合计 |
varchar(50) |
|
totalSales |
String |
销售总额(营业总收入) |
varchar(50) |
|
totalProfit |
String |
利润总额 |
varchar(50) |
|
primeBusProfit |
String |
主营业务收入 |
varchar(50) |
|
retainedProfit |
String |
净利润 |
varchar(50) |
|
totalTax |
String |
纳税总额 |
varchar(50) |
|
totalLiability |
String |
负债总额 |
varchar(50) |
|
companyId |
String |
公司id |
|
|
changeRecordList |
Array |
年报变更 |
|
|
_child |
Object |
|
|
|
reportYear |
String |
年份 |
varchar(20) |
|
changeItem |
String |
变更事项 |
varchar(4091) |
|
contentBefore |
String |
变更前 |
varchar(4091) |
|
contentAfter |
String |
变更后 |
varchar(4091) |
|
changeTime |
String |
变更时间 |
|
|
equityChangeInfoList |
Array |
股东股权变更信息 |
|
|
_child |
Object |
|
|
|
reportYear |
String |
年份 |
varchar(20) |
|
investorName |
String |
股东（发起人） |
varchar(100) |
|
ratioBefore |
String |
变更前股权比例 |
varchar(20) |
|
ratioAfter |
String |
变更后股权比例 |
varchar(20) |
|
changeTime |
String |
股权变更日期 |
|
|
outGuaranteeInfoList |
Array |
对外提供保证担保信息 |
|
|
_child |
Object |
|
|
|
reportYear |
String |
年份 |
varchar(20) |
|
creditor |
String |
债权人 |
varchar(50) |
|
obligor |
String |
债务人 |
varchar(50) |
|
creditoType |
String |
主债权种类 |
|
|
creditoAmount |
String |
主债权数额 |
varchar(50) |
|
creditoTerm |
String |
履行债务的期限 |
varchar(50) |
|
guaranteeTerm |
String |
保证的期间 |
varchar(50) |
|
guaranteeWay |
String |
保证的方式 |
varchar(50) |
|
guaranteeScope |
String |
保证担保的范围 |
varchar(50) |
|
outboundInvestmentList |
Array |
对外投资信息 |
|
|
_child |
Object |
|
|
|
reportYear |
String |
年份 |
varchar(20) |
|
outcompanyName |
String |
被投资公司 |
varchar(255) |
|
regNum |
String |
注册码 |
varchar(50) |
|
creditCode |
String |
社会统一信用代码 |
varchar(50) |
|
type |
undefined |
1-人 2-公司 |
|
|
clickId |
undefined |
被投资公司id |
|
|
shareholderList |
Array |
|
|
|
_child |
Object |
|
|
|
investorName |
String |
股东名称 |
varchar(255) |
|
subscribeAmount |
String |
认缴出资额 |
varchar(50) |
|
subscribeTime |
String |
认缴出资时间 |
|
|
subscribeType |
String |
认缴出资方式 |
varchar(50) |
|
paidAmount |
String |
实缴出资额 |
varchar(50) |
|
paidTime |
String |
实缴出资时间 |
|
|
paidType |
String |
实缴出资方式 |
varchar(50) |
|
type |
String |
1-人 2-公司 |
|
|
clickId |
String |
股东id |
|
|
reportYear |
String |
年份 |
varchar(20) |
|
webInfoList |
Array |
|
|
|
_child |
Object |
|
|
|
reportYear |
String |
年份 |
varchar(20) |
|
webType |
String |
网站类型 |
varchar(20) |
|
name |
String |
名称 |
varchar(500) |
|
website |
String |
网址 |
varchar(500) |
|
reportSocialSecurityInfo |
Object |
社保信息 |
|
|
id |
undefined |
对应表id |
|
|
annaulreportId |
Number |
年报id |
|
|
endowmentInsurance |
String |
城镇职工基本养老保险人数 |
varchar(50) |
|
unemploymentInsurance |
String |
失业保险人数 |
varchar(50) |
|
medicalInsurance |
String |
职工基本医疗保险人数 |
varchar(50) |
|
employmentInjuryInsurance |
String |
工伤保险 |
varchar(50) |
|
maternityInsurance |
String |
生育保险人数 |
varchar(50) |
|
endowmentInsuranceBase |
String |
单位参加城镇职工基本养老保险缴费基数 |
varchar(50) |
|
unemploymentInsuranceBase |
String |
单位参加失业保险缴费基数 |
varchar(50) |
|
medicalInsuranceBase |
String |
单位参加职工基本医疗保险缴费基数 |
varchar(50) |
|
maternityInsuranceBase |
String |
单位参加生育保险缴费基数 |
varchar(50) |
|
endowmentInsurancePayAmount |
String |
参加城镇职工基本养老保险本期实际缴费金额 |
varchar(50) |
|
unemploymentInsurancePayAmount |
String |
参加失业保险本期实际缴费金额 |
varchar(50) |
|
medicalInsurancePayAmount |
String |
参加职工基本医疗保险本期实际缴费金额 |
varchar(50) |
|
employmentInjuryInsurancePayAmount |
String |
参加工伤保险本期实际缴费金额 |
varchar(50) |
|
maternityInsurancePayAmount |
String |
参加生育保险本期实际缴费金额 |
varchar(50) |
|
endowmentInsuranceOweAmount |
String |
单位参加城镇职工基本养老保险累计欠缴金额 |
varchar(50) |
|
unemploymentInsuranceOweAmount |
String |
单位参加失业保险累计欠缴金额 |
varchar(50) |
|
medicalInsuranceOweAmount |
String |
单位参加职工基本医疗保险累计欠缴金额 |
varchar(50) |
|
employmentInjuryInsuranceOweAmount |
String |
单位参加工伤保险累计欠缴金额 |
varchar(50) |
|
maternityInsuranceOweAmount |
String |
单位参加生育保险累计欠缴金额 |
varchar(50) |
|
createTime |
Number |
创建时间 |
毫秒数 |
|
govReport |
undefined |
无用 |
|
|
type |
Number |
无用 |
|
1.3.分支机构
接口名称：分支机构
接口类型：数据获取
接口说明：通过企业全称或ID，获取该企业拥有公司总数、分支机构的企业名称、法定代表人、状态、注册时间、注册资金、评分等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/branch
请求方式：GET （HTTP请求）
完整URL示例： Url: http://api.yonyoucloud.com/apis/dst/background/branch?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
|
pageNum |
false |
String |
当前页数（默认第一页，每页20条） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文档结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
状态码 |
|
|
reason |
String |
错误信息 |
|
|
result |
Object |
|
|
|
total |
Number |
总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
toco |
Number |
拥有公司数量 |
|
|
logo |
String |
logo |
varchar(150) |
|
alias |
String |
简称 |
varchar(30) |
|
estiblishTime |
Number |
开业时间 |
毫秒数 |
|
regStatus |
String |
企业状态 |
varchar(31) |
|
type |
Number |
1-公司 2-人 |
|
|
legalPersonName |
String |
法人 |
varchar(120) |
|
pencertileScore |
Number |
评分 |
|
|
legalPersonId |
Number |
法人id |
|
|
id |
Number |
公司id |
|
|
category |
String |
行业code |
|
|
regCapital |
String |
注册资金 |
varchar(50) |
|
name |
String |
公司名 |
varchar(255) |
|
base |
String |
省份简称 |
varchar(10) |
|
personType |
Number |
法人类型： 1-人 2-公司 |
|
1.4.主要人员
接口名称：主要人员
接口类型：数据获取
接口说明：通过企业全称或ID，获取该企业的主要人员总数、各人员拥有公司总数、职位等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/staff
请求方式：GET （HTTP请求）
完整URL示例：http://api.yonyoucloud.com/apis/dst/background/staff?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
|
pageNum |
false |
String |
当前页数（默认第一页，每页20条） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文档结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
状态码 |
|
|
reason |
String |
|
|
|
result |
Object |
错误信息 |
|
|
total |
Number |
主要人员总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
toco |
Number |
拥有公司个数 |
|
|
id |
Number |
人或公司id |
|
|
typeJoin |
Array |
|
|
|
_child |
String |
职位 |
varchar(31) |
|
logo |
String |
logo |
varchar(150) |
|
type |
Number |
1-公司 2-人 |
|
|
name |
String |
主要人员名 |
varchar(50) |
1.5.股东信息
接口名称：股东信息
接口类型：数据获取
接口说明：通过企业全称或ID，获取该企业股东总数、股东名、各股东拥有公司个数以及出资金额、占比、认缴方式等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/holder
请求方式：GET （HTTP请求）
完整URL示例：http://api.yonyoucloud.com/apis/dst/background/holder?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
|
pageNum |
false |
String |
当前页数（默认第一页，每页20条） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文档结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
状态码 |
|
|
reason |
String |
错误信息 |
|
|
result |
Object |
|
|
|
total |
Number |
股东总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
id |
Number |
对应表id |
|
|
toco |
Number |
拥有公司个数 |
|
|
logo |
String |
logo |
varchar(150) |
|
name |
String |
股东名 |
varchar(50) |
|
capitalActl |
Array |
实缴 |
|
|
_child |
Object |
|
|
|
amomon |
String |
出资金额 |
varchar(50) |
|
time |
String |
出资时间 |
|
|
percent |
String |
占比 |
|
|
paymet |
String |
实缴方式 |
varchar(10) |
|
type |
Number |
1-公司 2-人 |
|
|
capital |
Array |
认缴 |
|
|
_child |
Object |
|
|
|
amomon |
String |
出资金额 |
varchar(50) |
|
time |
String |
出资时间 |
|
|
percent |
String |
占比 |
|
|
paymet |
String |
认缴方式 |
varchar(10) |
1.6.对外投资
接口名称：对外投资
接口类型：数据获取
接口说明：通过企业全称或ID，获取该企业对外投资的企业总数、企业名称、被投资法定代表人、注册资本、投资数额、投资占比、注册时间、状态等信息
接口地址：https://api.yonyoucloud.com/apis/dst/background/inverst
请求方式：GET （HTTP请求）
完整URL示例：http://api.yonyoucloud.com/apis/dst/background/inverst?name=用友网络科技股份有限公司&id=
授权认证方式：需要添加请求headerHttpGet get = new HttpGet(url); get.setHeader(“Authorization”, token);
请求参数：
|
参数 |
必选 |
类型及范围 |
说明 |
|
id |
false |
String |
公司id（id与name只需输入其中一个，id可以通过搜索接口获得） |
|
name |
false |
String |
公司名称（id与name只需输入其中一个） |
|
pageNum |
false |
String |
当前页数（默认第一页，每页20条） |
JSON返回示例：请参考https://api.yonyoucloud.com/apilink/tempServicePages/3d16b05b-845c-4518-93a3-073c5420da06_true.html页面内容
错误代码：请参考文档结尾处错误代码说明
返回字段说明：
|
返回值字段 |
字段类型 |
字段说明 |
备注 |
|
error_code |
Number |
装固态吗 |
|
|
reason |
String |
错误信息 |
|
|
result |
Object |
|
|
|
total |
Number |
对外投资总数 |
|
|
items |
Array |
|
|
|
_child |
Object |
|
|
|
orgType |
String |
公司类型 |
varchar(127) |
|
business_scope |
String |
经营范围 |
varchar(4091) |
|
percent |
String |
投资占比 |
|
|
regStatus |
String |
企业状态 |
varchar(50) |
|
estiblishTime |
Number |
开业时间 |
毫秒数 |
|
legalPersonName |
String |
法人 |
varchar(120) |
|
type |
Number |
1-公司 2-人 |
|
|
pencertileScore |
Number |
评分 |
|
|
legalPersonId |
Number |
法人id |
|
|
amount |
Number |
投资金额 |
|
|
id |
Number |
公司id |
|
|
category |
String |
行业 |
varchar(256) |
|
regCapital |
String |
注册资金 |
varchar(50) |
|
name |
String |
被投资公司 |
varchar(255) |
|
base |
String |
省份简称 |
varchar(10) |
|
creditCode |
String |
统一社会信用代码 |
varchar(18) |
|
personType |
Number |
1 人 2 公司 |
|
|
toco |
Number |
拥有公司数量 |
|
|
alias |
String |
简称 |
varchar(30) |
|
logo |
String |
logo |
varchar(150) |
2. 错误代码
|
代码 |
说明 |
|
0 |
请求成功 |
|
300000 |
无数据 |
|
300001 |
请求失败 |
|
300002 |
账号失效 |
|
300003 |
账号过期 |
|
300004 |
访问频率过快 |
|
300005 |
无权限访问此api |
|
300006 |
余额不足 |
|
300007 |
剩余次数不足 |
|
300008 |
缺少必要参数 |
|
300009 |
账号信息有误 |
|
300010 |
URL不存在 |