企业详情信息核验V2 - API文档

1. 概要

1.1 文档说明

本文档主要提供给互亿平台的用户对接接口的使用说明，开发者可以利用互亿无线提供的 HTTP 接口，调用互亿无线的实名认证服务。

1.2 提交方式

GET / POST

1.3 加密方式

1、采用 HTTPS 协议提交请求
2、通过 MD5 动态签名方式加密

1.4 API ID / API KEY

登录用户中心，进入【认证核验 – 企业信息验证】模块，在【产品总览】页面右侧，如下图所示：

2. 接交认证

2.1 接口描述

通过 POST、GET 方式进行提交，数据编码采用 utf-8 格式，24 小时全天提交。
内容格式为：Content-Type: application/x-www-form-urlencoded

2.2 请求地址

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

2.3 请求参数

注意：企业名称、统一社会信用代码、企业注册号、组织机构代码四选一传递

用户通过 http 或 https 提交请求到服务器后，服务器会返回一串 JSON 格式的字符串，SubmitResult 结构说明如下：

result.info.person 对象详细参数

result.info.basic 对象详细参数

result.info.techEnt 对象详细参数

2.4 响应示例

示例（成功）

{
    "code": 2,
    "msg": "提交成功",
    "idcardid": "25071815290210145",
    "result": {
        "info": {
            "person": [
                {
                    "personamount": "2",
                    "pername": "程**",
                    "entname": "上海思锐信息技术有限公司",
                    "position": "监事"
                },
                {
                    "personamount": "2",
                    "pername": "谢**",
                    "entname": "上海思锐信息技术有限公司",
                    "position": "执行董事"
                }
            ],
            "techEnt": [
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2025-12-14",
                    "certificateStateCode": "1",
                    "certificateLevel": "01",
                    "publishDate": "2022-12-14",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "有效",
                    "certificateNumber": "",
                    "entityName": "上海思锐信息技术有限公司",
                    "district": "",
                    "isHistory": "0",
                    "startDate": "2022-12-14",
                    "certificateType": "高新企业"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2018",
                    "endDate": "2018-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "02",
                    "publishDate": "2018-04-26",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "过期",
                    "certificateNumber": "",
                    "entityName": "上海思锐信息技术有限公司",
                    "district": "",
                    "isHistory": "1",
                    "startDate": "2018-04-26",
                    "certificateType": "科技型中小企业"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2022-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "01",
                    "publishDate": "2022-06-09",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "过期",
                    "certificateNumber": "",
                    "entityName": "上海思锐信息技术有限公司",
                    "district": "上海市金山区",
                    "isHistory": "1",
                    "startDate": "2022-06-09",
                    "certificateType": "科技型中小企业"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2022-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "01",
                    "publishDate": "2022-06-27",
                    "webPublicStatus": "2",
                    "checkDate": "",
                    "certificateState": "过期",
                    "certificateNumber": "202231011608008731",
                    "entityName": "上海思锐信息技术有限公司",
                    "district": "上海市",
                    "isHistory": "1",
                    "startDate": "2022-06-27",
                    "certificateType": "科技型中小企业"
                }
            ],
            "basic": {
                "esdate": "2004-04-20",
                "creditcode": "91310116761614322N",
                "dom": "上海市金山区亭林镇寺平南路16号444室",
                "zsopscope": "从事计算机领域内技术开发、技术服务、技术咨询，计算机网络工程，展览展示服务，企业管理咨询（除经纪），教育管理咨询（不得从事教育培训、中介、家教），市场营销策划，计算机、软件及辅助设备（除计算机信息系统安全专用产品），电子产品，通信设备销售，第二类增值电信业务中的信息服务业务（不含固定网电话信息服务和互联网信息服务）。【依法须经批准的项目，经相关部门批准后方可开展经营活动】",
                "revoke_reason": "",
                "enttype": "有限责任公司（自然人投资或控股）",
                "opfrom": "2004-04-20",
                "regorgdistrict": "金山区",
                "orgcodes": "761614322",
                "entname": "上海思锐信息技术有限公司",
                "postalcode": "201500",
                "regorg": "金山区市场监督管理局",
                "entname_old": "",
                "revdate": "",
                "frname": "谢**",
                "regno": "310116002008277",
                "opto": "",
                "ancheyear": "",
                "regcapcur": "人民币",
                "candate": "",
                "cancel_reason": "",
                "entitytype": "1",
                "regcap": "1000.0",
                "regorgcity": "上海市",
                "regorgprovince": "上海",
                "entstatus": "存续",
                "apprdate": "2023-05-31"
            }
        }
    }
}

注意：真实调用接口时，返回值涉及姓名的字段会返回完整姓名

示例（失败）

{"code":405,"msg":"用户名或密码不正确","idcardid":"0"}

2.5 响应参数

2.6 GET 请求示例

https://api.ihuyi.com/idcard/entinfov2/Submit.json?account=APIID&password=APIKEY&ent_name=上海xx信息技术有线公司

3、余额查询

3.1 接口描述

通过接口可以方便的查询你的账户剩余条数。

内容格式为：Content-Type: application/x-www-form-urlencoded

3.2 请求地址

https://api.ihuyi.com/idcard/entinfov2/GetNum.json

3.3 请求参数

用户通过 http 或 https 提交请求到服务器后，服务器会返回一串 json 格式的字符串，GetNumResult 结构说明如下：

3.4 响应示例

示例（成功）

{"code":2,"msg":"查询成功","num":123}

示例（失败）

{"code":405,"msg":"用户名或密码不正确","num":0}

3.5 响应参数

3.6 GET 请求示例

https://api.ihuyi.com/idcard/entinfov2/GetNum.json?account=APIID&password=APIKEY

4、生成动态密码方式

以 PHP 为例，提交认证的生成方式：

$time = time();
$password = md5($account.$apikey.$app.$ent_name.$ent_code.$time);

示例：

APIID： test
APIKEY：1q784322b******
app：entinfov2 // 固定值
ent_name：上海xx信息技术有限公司
ent_code: 91xxxxxxxxxxN
time：1651544941

结果：
$password = md5("test1q784322b******entinfov2上海xx信息技术有限公司91xxxxxxxxxxN1651544941");

注意：所有字符编码统一为 UTF-8。reg_no 和 organization_code 不参与 md5 校验。ent_name 或 ent_code 在未使用时可为空。

查询剩余条数的生成方式：

$time = time();
$password = md5($account.$apikey.$app.$time);

示例：

APIID： test
APIKEY：1q784322ba1******
app: entinfov2 // 固定值
time：1651544941

结果：
$password = md5("test1q784322ba1******entinfov21651544941");

Unix时间戳参考地址：http://tool.chinaz.com/Tools/unixtime.aspx