通過(guò)POST、 GET 方式進(jìn)行提交,數(shù)據(jù)編碼采用utf-8格式,支持24小時(shí)全天提交。
https://api.ihuyi.com/idcard/id3/Submit.json
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類(lèi)型 | 必填 |
| Content-Type | 內(nèi)容類(lèi)型,固定值 | application/x-www-form-urlencoded | string | 是 |
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類(lèi)型 | 必填 |
| account | APIID(用戶中心【認(rèn)證核驗(yàn)】-【身份信息驗(yàn)證】-【產(chǎn)品總覽】查看) | xxxxxxxx | string | 是 |
| password | 1、APIKEY(用戶中心【認(rèn)證核驗(yàn)】-【身份信息驗(yàn)證】-【產(chǎn)品總覽】查看) 2、動(dòng)態(tài)密碼(生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說(shuō)明) |
xxxxxxxxx | string | 是 |
| name | 身份證姓名 | 張三 | string | 是 |
| id_card_no | 身份證號(hào)碼 | 40122111****** | string | 是 |
| faceFile | 使用參數(shù),內(nèi)容格式需要改為:Content-Type: multipart/form-data 上傳人像圖片文件,大小為5KB-1MB 格式為jpg、jpeg、png、bmp | **.jpg | string | 否 |
| faceUrl | 人像圖片網(wǎng)址 | http://img.aa.com/demo.jpg | string | 否 |
| faceBase64 | 圖片內(nèi)容的Base64,如使用Base64,faceFileType為必填 | ****** | string | 否 |
| faceFileType | faceBase64圖片的文件格式:jpg、jpeg、png、bmp | jpg | string | 否 |
| time | Unix時(shí)間戳(10位整型數(shù)字,當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填) | 1623643787 | string | 否 |
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類(lèi)型 | 必返 |
| code | 返回值為2時(shí),表示提交成功 | 2|1 | int | 是 |
| msg | 提交結(jié)果描述 | 查詢成功|查詢失敗 | string | 是 |
| idcardid | 當(dāng)提交成功后,此字段為流水號(hào),否則為0或空 | 16236437872836|0 | string | 否 |
| result | 認(rèn)證結(jié)果 | object | 否 | |
| status | 狀態(tài)碼1 成功 2 照片質(zhì)量不合格 3 身份信息無(wú)效 | 2 | string | |
| score | 分值(0-1,分值越大相似度越高) | 0.91 | string | |
| remark | 錯(cuò)誤描述 | 成功 | string |
| code | msg |
| 0 | 未知錯(cuò)誤 |
| 1 | 提交失敗 |
| 2 | 提交成功 |
| 400 | 非法ip訪問(wèn) |
| 401 | 帳號(hào)不能為空 |
| 402 | 密碼不能為空 |
| 403 | 應(yīng)用不存在 |
| 404 | 姓名不能為空 |
| 4041 | 姓名格式不正確(2-10個(gè)中文漢字) |
| 406 | 身份證號(hào)碼不能為空 |
| 4061 | 身份證格式不正確 |
| 405 | API ID 或 API KEY 不正確 |
| 4050 | 賬號(hào)被凍結(jié) |
| 40501 | 動(dòng)態(tài)密碼已過(guò)期 |
| 40502 | 動(dòng)態(tài)密碼校驗(yàn)失敗 |
| 40505 | 沒(méi)有簽定合同 |
| 4051 | 剩余條數(shù)不足 |
| 4052 | 訪問(wèn) ip 與備案 ip 不符 |
| 4086 | 通道無(wú)效 |
| 4010 | 通道錯(cuò)誤 |
https://api.ihuyi.com/idcard/id3/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&name=張三&id_card_no=40122111******&faceFile=**.jpg&faceUrl=http://img.aa.com/demo.jpg&faceBase64=******&faceFileType=jpg&time=1623643787
示例(成功)
<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查詢成功</msg><idcardid>16236437872836</idcardid><result><status>2</status><score>0.91</score><remark>成功</remark></result></SubmitResult> {"code":2,"msg":"查詢成功","idcardid":"16236437872836","result":{"status":2,"score":0.91,"remark":成功}}
示例(失敗)
<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查詢失敗</msg></SubmitResult> {"code":1,"msg":"查詢失敗"}
$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'id3'; //固定值
$name = '張三';
$id_card_no = '40122111******';
$time = '1623643787';
$password=md5($account.$password.$app.$name.$id_card_no.$time);
$password=md5('xxxxxxxxxxxxxxxxxid3張三40122111******1623643787');
//注意:所有字符編碼統(tǒng)一為UTF-8
國(guó)內(nèi)專業(yè)互聯(lián)網(wǎng)團(tuán)隊(duì)
21年行業(yè)經(jīng)驗(yàn)
7x24小時(shí)售后支持
豐富的行業(yè)經(jīng)驗(yàn)
互 億 無(wú) 線 官 方 微 信 號(hào)
Copyright ? 2004-2025 上海思銳信息技術(shù)有限公司 All rights reserved. 滬ICP備07035915號(hào)-15 電信增值業(yè)務(wù)許可證:B2-20160082
服務(wù)熱線:
4008 808 898
服務(wù)熱線(工作時(shí)間):
4008 808 898
業(yè)務(wù)咨詢(非工作時(shí)間):
售后咨詢(非工作時(shí)間):
驗(yàn)證碼已發(fā)送到您的手機(jī),請(qǐng)查收!
輸入驗(yàn)證碼后,點(diǎn)擊“開(kāi)通體驗(yàn)賬戶”按鈕可立即開(kāi)通體驗(yàn)賬戶。