企业股权结构全景

提交查询

1、接口描述

请求支持 POST 和 GET 两种方法，字符编码为 utf-8 ，支持全天24小时发送。

2、请求地址

https://api.ihuyi.com/idcard/entoces/Submit.json

3、请求头说明

参数名称	参数值描述	示例	类型	必填
Content-Type	内容类型，固定值	application/x-www-form-urlencoded	string	是

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID（用户中心【认证核验】-【企业信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【企业信息验证】-【产品总览】查看) 2、动态密码（生成动态密码方式请看该文档末尾的说明）	xxxxxxxxx	string	是
ent_name	企业名称（ent_name、ent_code、organization_code、reg_no四选一传递）	上海************有限公司	string	否
ent_code	社会信用代码（ent_name、ent_code、organization_code、reg_no四选一传递）	913******	string	否
organization_code	组织机构代码（ent_name、ent_code、organization_code、reg_no四选一传递）	403925******	string	否
reg_no	注册号（ent_name、ent_code、organization_code、reg_no四选一传递）	403925******	string	否
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int
msg	提交结果描述	查询成功\|查询失败	string
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	查询结果		object
info	信息详情		object
entName	企业名称	上海******有限公司	string
shareholderDetail	股东详情	{"name":"上海****有限公司","type":"E","has_problem":"0","short_name":"***","amount":"","percent":"","sh_type":"","level":"0","identifier":"1","items":[{"name":"谢","type":"P","has_problem":"0","short_name":"谢","amount":"995.0","percent":"0.995","sh_type":"工商股东","level":"1","identifier":"2","items":[],"entity_id":"null"},{"name":"程","type":"P","has_problem":"0","short_name":"程*","amount":"5.0","percent":"0.005","sh_type":"工商股东","level":"1","identifier":"3","items":[],"entity_id":"null"}],"entity_id":"214118467"}	string
investmentDetail	对外投资详情	{"name":"上海****有限公司","type":"E","has_problem":"0","short_name":"**","amount":"","percent":"","sh_type":"","level":"0","identifier":"4","items":[{"name":"江苏公司","type":"E","has_problem":"0","short_name":"江苏*","amount":"700.0","percent":"0.7","sh_type":"工商股东","level":"1","identifier":"5","items":[],"entity_id":"542817869"}],"entity_id":"214118467"}	string
actualControllerId	实际控制人id	1e4c483df3be73fad176ed9d14074623	string
actualControllerName	实控人名称	谢*	string
actualControllerType	实控人类别	P	string
actualControllerPercent	实控人总持股	0.995000	string
actualControllerPath	实控人关系路径	{"nodes":[{"name":"谢","label":"P","iskey":true,"entity_id":"1e4c483df3be73fad176ed9d14074623"},{"name":"上海*****有限公司","label":"E","iskey":true,"entity_id":"214118467"}],"links":[{"sourceId":"1e4c483df3be73fad176ed9d14074623","targetId":"214118467","percent":"0.995","isMainPath":"1","lrDescDetail":""}]}	string
beneficiary	受益人列表	[]	array

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
406	企业名称、统代、组织机构代码、工商注册号四选一
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
4086	通道无效
4010	通道错误
4201	查询无结果
4202	查询失败
4203	参数有误或者不支持查询关键字，请检查

7、GET传参示例

https://api.ihuyi.com/idcard/entoces/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&ent_name=上海************有限公司&ent_code=913******&organization_code=403925******&reg_no=403925******&

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><idcardid>16236437872836</idcardid><result><info><entName>上海******有限公司</entName><shareholderDetail>{"name":"上海******有限公司","type":"E","has_problem":"0","short_name":"******","amount":"","percent":"","sh_type":"","level":"0","identifier":"1","items":[{"name":"谢*","type":"P","has_problem":"0","short_name":"谢*","amount":"995.0","percent":"0.995","sh_type":"工商股东","level":"1","identifier":"2","items":[],"entity_id":"null"},{"name":"程*","type":"P","has_problem":"0","short_name":"程*","amount":"5.0","percent":"0.005","sh_type":"工商股东","level":"1","identifier":"3","items":[],"entity_id":"null"}],"entity_id":"214118467"}</shareholderDetail><investmentDetail>{"name":"上海******有限公司","type":"E","has_problem":"0","short_name":"******","amount":"","percent":"","sh_type":"","level":"0","identifier":"4","items":[{"name":"江苏***公司","type":"E","has_problem":"0","short_name":"江苏**","amount":"700.0","percent":"0.7","sh_type":"工商股东","level":"1","identifier":"5","items":[],"entity_id":"542817869"}],"entity_id":"214118467"}</investmentDetail><actualControllerId>1e4c483df3be73fad176ed9d14074623</actualControllerId><actualControllerName>谢*</actualControllerName><actualControllerType>P</actualControllerType><actualControllerPercent>0.995000</actualControllerPercent><actualControllerPath>{"nodes":[{"name":"谢*","label":"P","iskey":true,"entity_id":"1e4c483df3be73fad176ed9d14074623"},{"name":"上海******有限公司","label":"E","iskey":true,"entity_id":"214118467"}],"links":[{"sourceId":"1e4c483df3be73fad176ed9d14074623","targetId":"214118467","percent":"0.995","isMainPath":"1","lrDescDetail":""}]}</actualControllerPath><beneficiary>[]</beneficiary></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "info":
                {    "entName":
            "上海******有限公司"
        ,        "shareholderDetail":
            "{\"name\":\"上海******有限公司\",\"type\":\"E\",\"has_problem\":\"0\",\"short_name\":\"******\",\"amount\":\"\",\"percent\":\"\",\"sh_type\":\"\",\"level\":\"0\",\"identifier\":\"1\",\"items\":[{\"name\":\"谢*\",\"type\":\"P\",\"has_problem\":\"0\",\"short_name\":\"谢*\",\"amount\":\"995.0\",\"percent\":\"0.995\",\"sh_type\":\"工商股东\",\"level\":\"1\",\"identifier\":\"2\",\"items\":[],\"entity_id\":\"null\"},{\"name\":\"程*\",\"type\":\"P\",\"has_problem\":\"0\",\"short_name\":\"程*\",\"amount\":\"5.0\",\"percent\":\"0.005\",\"sh_type\":\"工商股东\",\"level\":\"1\",\"identifier\":\"3\",\"items\":[],\"entity_id\":\"null\"}],\"entity_id\":\"214118467\"}"
        ,        "investmentDetail":
            "{\"name\":\"上海******有限公司\",\"type\":\"E\",\"has_problem\":\"0\",\"short_name\":\"******\",\"amount\":\"\",\"percent\":\"\",\"sh_type\":\"\",\"level\":\"0\",\"identifier\":\"4\",\"items\":[{\"name\":\"江苏***公司\",\"type\":\"E\",\"has_problem\":\"0\",\"short_name\":\"江苏**\",\"amount\":\"700.0\",\"percent\":\"0.7\",\"sh_type\":\"工商股东\",\"level\":\"1\",\"identifier\":\"5\",\"items\":[],\"entity_id\":\"542817869\"}],\"entity_id\":\"214118467\"}"
        ,        "actualControllerId":
            "1e4c483df3be73fad176ed9d14074623"
        ,        "actualControllerName":
            "谢*"
        ,        "actualControllerType":
            "P"
        ,        "actualControllerPercent":
            "0.995000"
        ,        "actualControllerPath":
            "{\"nodes\":[{\"name\":\"谢*\",\"label\":\"P\",\"iskey\":true,\"entity_id\":\"1e4c483df3be73fad176ed9d14074623\"},{\"name\":\"上海******有限公司\",\"label\":\"E\",\"iskey\":true,\"entity_id\":\"214118467\"}],\"links\":[{\"sourceId\":\"1e4c483df3be73fad176ed9d14074623\",\"targetId\":\"214118467\",\"percent\":\"0.995\",\"isMainPath\":\"1\",\"lrDescDetail\":\"\"}]}"
        ,        "beneficiary":
            "[]"
            }
                }
                }

示例（失败）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查询失败</msg></SubmitResult>

{"code":1,"msg":"查询失败"}

9、PHP生成动态密码方式代码示例

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'entoces'; //固定值
$ent_name = '上海************有限公司';
$ent_code = '913******';
$time = '1623643787';
$password=md5($account.$password.$app.$ent_name.$ent_code.$time);
$password=md5('xxxxxxxxxxxxxxxxxentoces上海************有限公司913******1623643787');

//注意：所有字符编码统一为UTF-8

企业股权结构全景

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

9、PHP生成动态密码方式代码示例

10、代码示例

5分钟快速自助开通免费体验账户