企业三要素验证（详版）

产品详情

提交查询

1、接口描述

提交查询

2、请求地址

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

3、请求头说明

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

4、请求参数说明

参数名称	参数值描述	示例	类型	必填
account	APIID(用户中心【认证核验】-【企业信息验证】-【产品总览】查看)	xxxxxxxx	string	是
password	1、APIKEY(用户中心【认证核验】-【企业信息验证】-【产品总览】查看) 2、动态密码(生成动态密码方式请看该文档末尾的说明)	xxxxxxxxx	string	是
ent_name	企业名称	上海xx信息技术有限公司	string	是
ent_code	统一社会信用代码	9121xxxxxxxxxN	string	是
name	核验人员姓名（用于核验该人员与企业的关系）	301xxxxxxx	string	是
time	Unix时间戳（10位整型数字，当使用动态密码方式时为必填）	1623643787	string	否

5、响应参数

参数名称	参数值描述	示例	类型	必返
code	返回值为2时，表示提交成功	2\|1	int	是
msg	提交结果描述	查询成功\|查询失败	string	是
idcardid	当提交成功后，此字段为流水号，否则为0或空	16236437872836\|0	string
result	认证结果		object
status	核验状态（2：验证成功，1：验证失败）	2	string
info	信息详情		object
entinfo	企业信息		object
esdate	成立日期	2020-01-01	string
ent_name_result	企业名称是否匹配（1：是2：否	1	string
entstatus_result	企业状态（1：在营：2：非在营）	1	string
creditcode_result	统一社会信用代码是否匹配（1：是2：否）	1	string
opfrom	经营期限自	2020-01-01	string
opto	经营期限至	2030-01-01	string
enttype_result	企业类型（1：企业：2：个体）	1	string
relation	企业主关系		object
inv_result	核验人员是否股东（1：是；2：否）	1	string
person_name_result	核验人员姓名是否匹配（1：是；2：否）	1	string
fr_result	核验人员是否法人（1：是；2：否）	1	string
manager_result	核验人员是否高管（1：是；2：否）	1	string

6、响应状态码说明

code	msg
0	未知错误
1	提交失败
2	提交成功
400	非法ip访问
401	帐号不能为空
402	密码不能为空
403	应用不存在
404	核验人员不能为空
405	API ID 或 API KEY 不正确
4050	账号被冻结
40501	动态密码已过期
40502	动态密码校验失败
40505	没有签定合同
4051	剩余条数不足
4052	访问 ip 与备案 ip 不符
409	公司名称不能为空
4091	公司名称格式不正确
411	统一社会信用代码不能为空
4111	统一社会信用代码格式不正确
4086	通道无效
4010	通道错误
4201	统一代码不一致，查询无结果
4202	企业名称不一致，查询无结果
4203	企业名称与统一代码均查询无结果

7、GET传参示例

https://api.ihuyi.com/idcard/ent3fv2/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&ent_name=上海xx信息技术有限公司&ent_code=9121xxxxxxxxxN&name=301xxxxxxx&time=1623643787

8、响应示例

示例（成功）

<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查询成功</msg><idcardid>16236437872836</idcardid><result><status>2</status><info><entinfo><esdate>2020-01-01</esdate><ent_name_result>1</ent_name_result><entstatus_result>1</entstatus_result><creditcode_result>1</creditcode_result><opfrom>2020-01-01</opfrom><opto>2030-01-01</opto><enttype_result>1</enttype_result></entinfo><relation><inv_result>1</inv_result><person_name_result>1</person_name_result><fr_result>1</fr_result><manager_result>1</manager_result></relation></info></result></SubmitResult>

{    "code":
            2
        ,        "msg":
            "查询成功"
        ,        "idcardid":
            "16236437872836"
        ,        "result":
                {    "status":
                "2"
                    ,        "info":
                {    "entinfo":
        {    "esdate":
        "2020-01-01"
    ,        "ent_name_result":
        "1"
    ,        "entstatus_result":
        "1"
    ,        "creditcode_result":
        "1"
    ,        "opfrom":
        "2020-01-01"
    ,        "opto":
        "2030-01-01"
    ,        "enttype_result":
        "1"
        }
        ,        "relation":
        {    "inv_result":
        "1"
    ,        "person_name_result":
        "1"
    ,        "fr_result":
        "1"
    ,        "manager_result":
        "1"
        }
            }
                }
                }

示例（失败）

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

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

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

$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'ent3fv2'; //固定值
$ent_name = '上海xx信息技术有限公司';
$ent_code = '9121xxxxxxxxxN';
$name = '301xxxxxxx';
$time = '1623643787';
$password=md5($account.$password.$app.$ent_name.$ent_code.$name.$time);
$password=md5('xxxxxxxxxxxxxxxxxent3fv2上海xx信息技术有限公司9121xxxxxxxxxN301xxxxxxx1623643787');

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

企业三要素验证（详版）

提交查询

1、接口描述

2、请求地址

3、请求头说明

4、请求参数说明

5、响应参数

6、响应状态码说明

7、GET传参示例

8、响应示例

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

10、代码示例

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