1. 概要

1.1 文檔說明

本文檔主要提供給互億平臺的用戶對接接口的使用說明，開發(fā)者可以利用互億無線提供的 HTTP 接口，調(diào)用互億無線的實名認(rèn)證服務(wù)。

1.2 提交方式

GET / POST

1.3 加密方式

1、采用 HTTPS 協(xié)議提交請求
2、通過 MD5 動態(tài)簽名方式加密

1.4 API ID / API KEY

登錄用戶中心，進(jìn)入【認(rèn)證核驗 – 企業(yè)信息驗證】模塊，在【產(chǎn)品總覽】頁面右側(cè)，如下圖所示：

2. 接交認(rèn)證

2.1 接口描述

通過 POST、GET 方式進(jìn)行提交，數(shù)據(jù)編碼采用 utf-8 格式，24 小時全天提交。
內(nèi)容格式為：Content-Type: application/x-www-form-urlencoded

2.2 請求地址

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

2.3 請求參數(shù)

注意：企業(yè)名稱、統(tǒng)一社會信用代碼、企業(yè)注冊號、組織機構(gòu)代碼四選一傳遞

用戶通過 http 或 https 提交請求到服務(wù)器后，服務(wù)器會返回一串 JSON 格式的字符串，SubmitResult 結(jié)構(gòu)說明如下：

result.info.person 對象詳細(xì)參數(shù)

result.info.basic 對象詳細(xì)參數(shù)

result.info.techEnt 對象詳細(xì)參數(shù)

2.4 響應(yīng)示例

示例（成功）

{
    "code": 2,
    "msg": "提交成功",
    "idcardid": "25071815290210145",
    "result": {
        "info": {
            "person": [
                {
                    "personamount": "2",
                    "pername": "程**",
                    "entname": "上海思銳信息技術(shù)有限公司",
                    "position": "監(jiān)事"
                },
                {
                    "personamount": "2",
                    "pername": "謝**",
                    "entname": "上海思銳信息技術(shù)有限公司",
                    "position": "執(zhí)行董事"
                }
            ],
            "techEnt": [
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2025-12-14",
                    "certificateStateCode": "1",
                    "certificateLevel": "01",
                    "publishDate": "2022-12-14",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "有效",
                    "certificateNumber": "",
                    "entityName": "上海思銳信息技術(shù)有限公司",
                    "district": "",
                    "isHistory": "0",
                    "startDate": "2022-12-14",
                    "certificateType": "高新企業(yè)"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2018",
                    "endDate": "2018-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "02",
                    "publishDate": "2018-04-26",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "過期",
                    "certificateNumber": "",
                    "entityName": "上海思銳信息技術(shù)有限公司",
                    "district": "",
                    "isHistory": "1",
                    "startDate": "2018-04-26",
                    "certificateType": "科技型中小企業(yè)"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2022-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "01",
                    "publishDate": "2022-06-09",
                    "webPublicStatus": "1",
                    "checkDate": "",
                    "certificateState": "過期",
                    "certificateNumber": "",
                    "entityName": "上海思銳信息技術(shù)有限公司",
                    "district": "上海市金山區(qū)",
                    "isHistory": "1",
                    "startDate": "2022-06-09",
                    "certificateType": "科技型中小企業(yè)"
                },
                {
                    "cancelDate": "",
                    "districtCode": "310116",
                    "certificateYear": "2022",
                    "endDate": "2022-12-31",
                    "certificateStateCode": "3",
                    "certificateLevel": "01",
                    "publishDate": "2022-06-27",
                    "webPublicStatus": "2",
                    "checkDate": "",
                    "certificateState": "過期",
                    "certificateNumber": "202231011608008731",
                    "entityName": "上海思銳信息技術(shù)有限公司",
                    "district": "上海市",
                    "isHistory": "1",
                    "startDate": "2022-06-27",
                    "certificateType": "科技型中小企業(yè)"
                }
            ],
            "basic": {
                "esdate": "2004-04-20",
                "creditcode": "91310116761614322N",
                "dom": "上海市金山區(qū)亭林鎮(zhèn)寺平南路16號444室",
                "zsopscope": "從事計算機領(lǐng)域內(nèi)技術(shù)開發(fā)、技術(shù)服務(wù)、技術(shù)咨詢，計算機網(wǎng)絡(luò)工程，展覽展示服務(wù)，企業(yè)管理咨詢（除經(jīng)紀(jì)），教育管理咨詢（不得從事教育培訓(xùn)、中介、家教），市場營銷策劃，計算機、軟件及輔助設(shè)備（除計算機信息系統(tǒng)安全專用產(chǎn)品），電子產(chǎn)品，通信設(shè)備銷售，第二類增值電信業(yè)務(wù)中的信息服務(wù)業(yè)務(wù)（不含固定網(wǎng)電話信息服務(wù)和互聯(lián)網(wǎng)信息服務(wù)）?！疽婪毥?jīng)批準(zhǔn)的項目，經(jīng)相關(guān)部門批準(zhǔn)后方可開展經(jīng)營活動】",
                "revoke_reason": "",
                "enttype": "有限責(zé)任公司（自然人投資或控股）",
                "opfrom": "2004-04-20",
                "regorgdistrict": "金山區(qū)",
                "orgcodes": "761614322",
                "entname": "上海思銳信息技術(shù)有限公司",
                "postalcode": "201500",
                "regorg": "金山區(qū)市場監(jiān)督管理局",
                "entname_old": "",
                "revdate": "",
                "frname": "謝**",
                "regno": "310116002008277",
                "opto": "",
                "ancheyear": "",
                "regcapcur": "人民幣",
                "candate": "",
                "cancel_reason": "",
                "entitytype": "1",
                "regcap": "1000.0",
                "regorgcity": "上海市",
                "regorgprovince": "上海",
                "entstatus": "存續(xù)",
                "apprdate": "2023-05-31"
            }
        }
    }
}

注意：真實調(diào)用接口時，返回值涉及姓名的字段會返回完整姓名

示例（失敗）

{"code":405,"msg":"用戶名或密碼不正確","idcardid":"0"}

2.5 響應(yīng)參數(shù)

2.6 GET 請求示例

https://api.ihuyi.com/idcard/entinfov2/Submit.json?account=APIID&password=APIKEY&ent_name=上海xx信息技術(shù)有線公司

3、余額查詢

3.1 接口描述

通過接口可以方便的查詢你的賬戶剩余條數(shù)。

內(nèi)容格式為：Content-Type: application/x-www-form-urlencoded

3.2 請求地址

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

3.3 請求參數(shù)

用戶通過 http 或 https 提交請求到服務(wù)器后，服務(wù)器會返回一串 json 格式的字符串，GetNumResult 結(jié)構(gòu)說明如下：

3.4 響應(yīng)示例

示例（成功）

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

示例（失?。?/p>

{"code":405,"msg":"用戶名或密碼不正確","num":0}

3.5 響應(yīng)參數(shù)

3.6 GET 請求示例

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

4、生成動態(tài)密碼方式

以 PHP 為例，提交認(rèn)證的生成方式：

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

示例：

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

結(jié)果：
$password = md5("test1q784322b******entinfov2上海xx信息技術(shù)有限公司91xxxxxxxxxxN1651544941");

注意：所有字符編碼統(tǒng)一為 UTF-8。reg_no 和 organization_code 不參與 md5 校驗。ent_name 或 ent_code 在未使用時可為空。

查詢剩余條數(shù)的生成方式：

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

示例：

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

結(jié)果：
$password = md5("test1q784322ba1******entinfov21651544941");

Unix時間戳參考地址：http://tool.chinaz.com/Tools/unixtime.aspx