通過POST、 GET 方式進行提交,數(shù)據(jù)編碼采用utf-8格式,支持24小時全天提交。
https://api.ihuyi.com/idcard/idface/Submit.json
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類型 | 必填 |
| Content-Type | 內(nèi)容類型,固定值 | application/x-www-form-urlencoded | string | 是 |
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類型 | 必填 |
| account | APIID(用戶中心【認證核驗】-【身份信息驗證】-【產(chǎn)品總覽】查看) | xxxxxxxx | string | 是 |
| password | 1、APIKEY(用戶中心【認證核驗】-【身份信息驗證】-【產(chǎn)品總覽】查看) 2、動態(tài)密碼(生成動態(tài)密碼方式請看該文檔末尾的說明) |
xxxxxxxxx | string | 是 |
| name | 身份證姓名 | 張三 | string | 是 |
| id_card_no | 身份證號碼 | 40122111****** | string | 是 |
| faceType | 對接方式(固定值 H5或SDK) | H5 | string | 是 |
| callbackUrl | H5方式認證完成后的回調(diào)地址 | https://******* | string | 否 |
| notifyUrl | SDK認證完后的異步通知地址 | https://******* | string | 否 |
| time | Unix時間戳(10位整型數(shù)字,當使用動態(tài)密碼方式時為必填) | 1623643787 | string | 否 |
| 參數(shù)名稱 | 參數(shù)值描述 | 示例 | 類型 | 必返 |
| code | 返回值為2時,表示提交成功 | 2|1 | int | 是 |
| msg | 提交結(jié)果描述 | 查詢成功|查詢失敗 | string | 是 |
| idcardid | 當提交成功后,此字段為流水號,否則為0或空 | 16236437872836|0 | string | 否 |
| result | 認證結(jié)果 | object | 否 | |
| expire | url或faceToken的過期時間 | 1750918770965 | string | |
| originalUrl | H5的刷臉認證地址 | string | ||
| faceToken | SDK的刷臉認證Token | c02008be0a764c7e8f36d9c78773c6f5 | string |
| code | msg |
| 0 | 未知錯誤 |
| 1 | 提交失敗 |
| 2 | 提交成功 |
| 400 | 非法ip訪問 |
| 401 | 帳號不能為空 |
| 402 | 密碼不能為空 |
| 403 | 應(yīng)用不存在 |
| 404 | 姓名不能為空 |
| 4041 | 姓名格式不正確(2-10個中文漢字) |
| 406 | 身份證號碼不能為空 |
| 4061 | 身份證格式不正確 |
| 405 | API ID 或 API KEY 不正確 |
| 4050 | 賬號被凍結(jié) |
| 40501 | 動態(tài)密碼已過期 |
| 40502 | 動態(tài)密碼校驗失敗 |
| 40505 | 沒有簽定合同 |
| 4051 | 剩余條數(shù)不足 |
| 4052 | 訪問 ip 與備案 ip 不符 |
| 4086 | 通道無效 |
| 4010 | 通道錯誤 |
https://api.ihuyi.com/idcard/idface/Submit.json?account=xxxxxxxx&password=xxxxxxxxx&name=張三&id_card_no=40122111******&faceType=H5&callbackUrl=https://*******¬ifyUrl=https://*******&time=1623643787
示例(成功)
<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>2</code><msg>查詢成功</msg><idcardid>16236437872836</idcardid><result><expire>1750918770965</expire><originalUrl></originalUrl><faceToken>c02008be0a764c7e8f36d9c78773c6f5</faceToken></result></SubmitResult> {"code":2,"msg":"查詢成功","idcardid":"16236437872836","result":{"expire":1750918770965,"originalUrl":,"faceToken":c02008be0a764c7e8f36d9c78773c6f5}}
示例(失?。?/p>
<?xml version="1.0" encoding="utf-8"?><SubmitResult><code>1</code><msg>查詢失敗</msg></SubmitResult> {"code":1,"msg":"查詢失敗"}
$account = 'xxxxxxxx';
$password = 'xxxxxxxxx';
$app = 'idface'; //固定值
$name = '張三';
$id_card_no = '40122111******';
$time = '1623643787';
$password=md5($account.$password.$app.$name.$id_card_no.$time);
$password=md5('xxxxxxxxxxxxxxxxxidface張三40122111******1623643787');
//注意:所有字符編碼統(tǒng)一為UTF-8
國內(nèi)專業(yè)互聯(lián)網(wǎng)團隊
21年行業(yè)經(jīng)驗
7x24小時售后支持
豐富的行業(yè)經(jīng)驗
Copyright ? 2004-2025 上海思銳信息技術(shù)有限公司 All rights reserved. 滬ICP備07035915號-15 電信增值業(yè)務(wù)許可證:B2-20160082
服務(wù)熱線:
4008 808 898
服務(wù)熱線(工作時間):
4008 808 898
業(yè)務(wù)咨詢(非工作時間):
售后咨詢(非工作時間):
驗證碼已發(fā)送到您的手機,請查收!
輸入驗證碼后,點擊“開通體驗賬戶”按鈕可立即開通體驗賬戶。