企業(yè)詳情信息核驗(yàn)V2文檔 點(diǎn)擊下載
企業(yè)詳情信息核驗(yàn)接入指南 點(diǎn)擊訪問
本文檔主要提供給互億平臺(tái)的用戶對(duì)接接口的使用說明,開發(fā)者可以利用互億無線提供的 HTTP 接口,調(diào)用互億無線的實(shí)名認(rèn)證服務(wù)。
GET / POST
1、采用 HTTPS 協(xié)議提交請(qǐng)求
2、通過 MD5 動(dòng)態(tài)簽名方式加密
登錄用戶中心,進(jìn)入【認(rèn)證核驗(yàn) – 企業(yè)信息驗(yàn)證】模塊,在【產(chǎn)品總覽】頁面右側(cè),如下圖所示:
通過 POST、GET 方式進(jìn)行提交,數(shù)據(jù)編碼采用 utf-8 格式,24 小時(shí)全天提交。
內(nèi)容格式為:Content-Type: application/x-www-form-urlencoded
https://api.ihuyi.com/idcard/entinfov2/Submit.json
參數(shù)名稱 | 參數(shù)值描述 | 必填 |
account | APIID(用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看) | 是 |
password | 1、APIKEY(用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看) 2、動(dòng)態(tài)密碼(生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明) |
是 |
ent_name | 企業(yè)名稱 | 否 |
ent_code | 統(tǒng)一社會(huì)信用代碼 | 否 |
reg_no | 企業(yè)注冊(cè)號(hào) | 否 |
organization_code | 組織機(jī)構(gòu)代碼 | 否 |
time | Unix 時(shí)間戳(10 位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填) | 否 |
注意:企業(yè)名稱、統(tǒng)一社會(huì)信用代碼、企業(yè)注冊(cè)號(hào)、組織機(jī)構(gòu)代碼四選一傳遞
用戶通過 http 或 https 提交請(qǐng)求到服務(wù)器后,服務(wù)器會(huì)返回一串 JSON 格式的字符串,SubmitResult 結(jié)構(gòu)說明如下:
參數(shù)名稱 | 類型 | 描述 |
code | int | 返回值為 2 時(shí),表示提交成功 |
idcardid | string | 當(dāng)提交成功后,此字段為流水號(hào),否則為 0 |
msg | string | 提交結(jié)果描述 |
result | object | 查詢結(jié)果 |
result.info | object | 其他參數(shù) |
result.info.person | object | 主要管理人員(字段說明見后表) |
result.info.basic | object | 企業(yè)基本信息(字段說明見后表) |
result.info.techEnt | object | 科技企業(yè)信息(字段說明見后表) |
result.info.person 對(duì)象詳細(xì)參數(shù)
參數(shù)名稱 | 類型 | 描述 |
entname | string | 企業(yè)名稱 |
pername | string | 高管姓名 |
position | string | 職位 |
personamount | string | 高管總數(shù)量 |
result.info.basic 對(duì)象詳細(xì)參數(shù)
參數(shù)名稱 | 類型 | 描述 |
orgcodes | string | 組織機(jī)構(gòu)代碼 |
regno | string | 注冊(cè)號(hào) |
creditcode | string | 統(tǒng)一信用代碼 |
opfrom | string | 經(jīng)營(yíng)期限自 |
opto | string | 經(jīng)營(yíng)期限至 |
entname | string | 企業(yè)名稱 |
regcap | string | 注冊(cè)資本(企業(yè):萬元) |
ancheyear | string | 最后年檢年度 |
esdate | string | 成立日期 |
frname | string | 法定代表人/負(fù)責(zé)人執(zhí)行事務(wù)合伙人 |
regorg | string | 登記機(jī)關(guān) |
entstatus | string | 經(jīng)營(yíng)狀態(tài) |
enttype | string | 企業(yè)類型 |
regorgprovince | string | 所在省份 |
regorgcity | string | 所在城市 |
regorgdistrict | string | 所在區(qū)/縣 |
regcapcur | string | 注冊(cè)資本幣種 |
postalcode | string | 郵編 |
revdate | string | 吊銷日期 |
revoke_reason | string | 吊銷原因 |
candate | string | 注銷日期 |
cancel_reason | string | 注銷原因 |
zsopscope | string | 經(jīng)營(yíng)業(yè)務(wù)范圍 |
entitytype | string | 實(shí)體類型(1企業(yè),2個(gè)體,3其他) |
entname_old | string | 曾用名 |
apprdate | string | 核準(zhǔn)日期 |
dom | string | 地址 |
result.info.techEnt 對(duì)象詳細(xì)參數(shù)
參數(shù)名稱 | 類型 | 描述 |
entityName | string | 公司名稱 |
certificateType | string | 類型 |
district | string | 所在地區(qū) |
districtCode | string | 區(qū)域代碼 |
certificateNumber | string | 許可證號(hào) |
certificateYear | string | 年份 |
webPublicStatus | string | 網(wǎng)站公布狀態(tài) |
publishDate | string | 發(fā)布日期 |
certificateLevel | string | 級(jí)別 (01:國(guó)家級(jí);02:省級(jí);03:市級(jí);04:縣區(qū)級(jí)) |
startDate | string | 入庫(kù)登記日期/有效期起 |
endDate | string | 有效期至 |
checkDate | string | 復(fù)核日期 |
cancelDate | string | 資質(zhì)終止日期撤銷日期 |
certificateState | string | 許可證狀態(tài) |
certificateStateCode | string | 許可證狀態(tài)碼 |
isHistory | string | 是否歷史(0:否;1:歷史) |
示例(成功)
{ "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號(hào)444室", "zsopscope": "從事計(jì)算機(jī)領(lǐng)域內(nèi)技術(shù)開發(fā)、技術(shù)服務(wù)、技術(shù)咨詢,計(jì)算機(jī)網(wǎng)絡(luò)工程,展覽展示服務(wù),企業(yè)管理咨詢(除經(jīng)紀(jì)),教育管理咨詢(不得從事教育培訓(xùn)、中介、家教),市場(chǎng)營(yíng)銷策劃,計(jì)算機(jī)、軟件及輔助設(shè)備(除計(jì)算機(jī)信息系統(tǒng)安全專用產(chǎn)品),電子產(chǎn)品,通信設(shè)備銷售,第二類增值電信業(yè)務(wù)中的信息服務(wù)業(yè)務(wù)(不含固定網(wǎng)電話信息服務(wù)和互聯(lián)網(wǎng)信息服務(wù))。【依法須經(jīng)批準(zhǔn)的項(xiàng)目,經(jīng)相關(guān)部門批準(zhǔn)后方可開展經(jīng)營(yíng)活動(dòng)】", "revoke_reason": "", "enttype": "有限責(zé)任公司(自然人投資或控股)", "opfrom": "2004-04-20", "regorgdistrict": "金山區(qū)", "orgcodes": "761614322", "entname": "上海思銳信息技術(shù)有限公司", "postalcode": "201500", "regorg": "金山區(qū)市場(chǎng)監(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" } } } }
注意:真實(shí)調(diào)用接口時(shí),返回值涉及姓名的字段會(huì)返回完整姓名
示例(失?。?/p>
{"code":405,"msg":"用戶名或密碼不正確","idcardid":"0"}
code | msg |
0 | 未知錯(cuò)誤 |
1 | 提交失敗 |
2 | 提交成功 |
400 | 非法ip訪問 |
401 | 帳號(hào)不能為空 |
402 | 密碼不能為空 |
403 | 應(yīng)用不存在 |
408 | 查詢無結(jié)果 |
405 | API ID或API KEY不正確 |
4050 | 賬號(hào)被凍結(jié) |
40501 | 動(dòng)態(tài)密碼已過期 |
40502 | 動(dòng)態(tài)密碼校驗(yàn)失敗 |
40505 | 沒有簽定合同 |
4051 | 剩余條數(shù)不足 |
4052 | 訪問ip與備案ip不符 |
4086 | 通道無效 |
4010 | 通道錯(cuò)誤 |
4201 | 查詢無結(jié)果 |
4202 | 查詢失敗 |
https://api.ihuyi.com/idcard/entinfov2/Submit.json?account=APIID&password=APIKEY&ent_name=上海xx信息技術(shù)有線公司
通過接口可以方便的查詢你的賬戶剩余條數(shù)。
內(nèi)容格式為:Content-Type: application/x-www-form-urlencoded
https://api.ihuyi.com/idcard/entinfov2/GetNum.json
參數(shù)名稱 | 參數(shù)值描述 | 必填 |
account | APIID(用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看) | 是 |
password | 1、APIKEY(用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看) 2、動(dòng)態(tài)密碼(生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明) |
是 |
time | Unix時(shí)間戳(10位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填) | 否 |
用戶通過 http 或 https 提交請(qǐng)求到服務(wù)器后,服務(wù)器會(huì)返回一串 json 格式的字符串,GetNumResult 結(jié)構(gòu)說明如下:
參數(shù)名稱 | 類型 | 描述 |
code | int | 狀態(tài)返回值 |
msg | string | 查詢結(jié)果描述 |
num | string | 剩余數(shù)量 |
示例(成功)
{"code":2,"msg":"查詢成功","num":123}
示例(失敗)
{"code":405,"msg":"用戶名或密碼不正確","num":0}
code | msg |
2 | 查詢成功 |
400 | 非法ip訪問 |
401 | 帳號(hào)不能為空 |
402 | 密碼不能為空 |
403 | 應(yīng)用不存在 |
405 | API ID或API KEY不正確 |
4050 | 賬號(hào)被凍結(jié) |
40501 | 動(dòng)態(tài)密碼已過期 |
40502 | 動(dòng)態(tài)密碼校驗(yàn)失敗 |
4052 | 訪問ip與備案ip不符 |
https://api.ihuyi.com/idcard/entinfov2/GetNum.json?account=APIID&password=APIKEY
以 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 校驗(yàn)。ent_name 或 ent_code 在未使用時(shí)可為空。
查詢剩余條數(shù)的生成方式:
$time = time(); $password = md5($account.$apikey.$app.$time);
示例:
APIID: test APIKEY:1q784322ba1****** app: entinfov2 // 固定值 time:1651544941 結(jié)果: $password = md5("test1q784322ba1******entinfov21651544941");
Unix時(shí)間戳參考地址:http://tool.chinaz.com/Tools/unixtime.aspx
驗(yàn)證碼已發(fā)送到您的手機(jī),請(qǐng)查收!
輸入驗(yàn)證碼后,點(diǎn)擊“開通體驗(yàn)賬戶”按鈕可立即開通體驗(yàn)賬戶。