身份證二要素認證接口文檔

互億無線身份證二要素認證API中國·上海4008808898互億無線身份證二要素認證API接口說明文件標識Ihuyi_IDCARDAPI版本編號V1.1發(fā)布者上海思銳信息技術(shù)有限公司發(fā)布日期2022-09-09最新更新2023-07-03

目錄 62741.概要 3302501.1文檔說明 383091.2提交方式 3138221.3加密方式 3239571.4APIID/APIKEY 3322372.接交認證 3103592.1接口描述 3213322.2請求地址 3111972.3請求參數(shù) 4200252.4響應(yīng)示例 5326572.5響應(yīng)參數(shù) 534092.6GET請求示例 6312743.余額查詢 6161353.1接口描述 695103.2請求地址 640583.3請求參數(shù) 617873.4響應(yīng)示例 742383.5響應(yīng)參數(shù) 7104613.6GET請求示例 7314944.生成動態(tài)密碼方式 7175975.如何實現(xiàn)UNIX時間戳 8129866.DEMO示例 992917.aes加密示例 1015837.1PHP示例 10166867.2java示例 1084108.聯(lián)系方式 10

1.概要1.1文檔說明本文檔主要提供給互億平臺的用戶對接接口的使用說明，開發(fā)者可以利用互億無線提供的HTTP接口，調(diào)用互億無線的實名認證服務(wù)。1.2提交方式GET/POST1.3加密方式1、采用HTTPS協(xié)議提交請求2、通過MD5動態(tài)簽名方式加密1.4APIID/APIKEY登錄用戶中心，進入【實名認證】模塊，在【產(chǎn)品總覽】頁面右側(cè)，如下圖所示：2.接交認證2.1接口描述通過POST、GET方式進行提交，數(shù)據(jù)編碼采用utf-8格式，24小時全天提交。內(nèi)容格式為：Content-Type:application/x-www-form-urlencoded2.2請求地址/idcard/Submit.json2.3請求參數(shù)參數(shù)名稱參數(shù)值描述必填accountAPIID（用戶中心【實名認證】-【產(chǎn)品總覽】查看）是password1、APIKEY（用戶中心【實名認證】-【產(chǎn)品總覽】查看）2、動態(tài)密碼（生成動態(tài)密碼方式請看該文檔末尾的說明）是appid2是name身份證姓名是id_card_no身份證號碼是timeUnix時間戳（10位整型數(shù)字，當(dāng)使用動態(tài)密碼方式時為必填）否info_crypt_mode此參數(shù)用于指定內(nèi)容的加密方式，用戶可選擇aes或piece_md5。、若選擇aes，則需將name和id_card_no字段使用AES加密。具體加密方法請參照文檔末尾提供的示例。、若選擇piece_md5，則：name字段的第一個字符將被替換為相應(yīng)的32位小寫MD5值。（例如：名字“張三”中的第一個字符“張”變?yōu)椤?499fc7409049355527ef6a2ba5706b8”，結(jié)果為“6499fc7409049355527ef6a2ba5706b8三”。）id_card_no字段中的生日部分也將被替換為32位小寫MD5值。（例如，身份證號碼中的生日“19980709”將被替換為“89bb8cbeb92b47835efb1c330b79deba”，結(jié)果為“41012489bb8cbeb92b47835efb1c330b79deba152X”。）否用戶通過http或https提交請求到服務(wù)器后，服務(wù)器會返回一串json格式的字符串，SubmitResult結(jié)構(gòu)說明如下：參數(shù)名稱類型描述codeint返回值為2時，表示提交成功idcardidstring當(dāng)提交成功后，此字段為流水號，否則為0msgstring提交結(jié)果描述resultobject認證結(jié)果result.statusint認證狀態(tài)（0未認證，1認證未通過，2認證通過）object保留字段2.4響應(yīng)示例示例（成功）{"code":2,"msg":"提交成功","idcardid":"16236437872836","result":{"status":2,"info":{}}}示例（失?。﹞"code":405,"msg":"用戶名或密碼不正確","idcardid":"0","result":{"status":0,"info":{}}}2.5響應(yīng)參數(shù)codemsg0未知錯誤1提交失敗2提交成功400非法ip訪問401帳號不能為空402密碼不能為空403應(yīng)用不存在404姓名不能為空4041姓名格式不正確（2-10個中文漢字）406身份證號碼不能為空4061身份證號碼格式不正確405APIID或APIKEY不正確4050賬號被凍結(jié)40501動態(tài)密碼已過期40502動態(tài)密碼校驗失敗40505沒有簽定合同4051剩余條數(shù)不足4052訪問ip與備案ip不符4086通道無效4010通道錯誤2.6GET請求示例/idcard/Submit.json&account=APIID&password=APIKEY&app=id2&name=姓名&id_card_no=401123343333xxxxxxxxxxxxxx3.余額查詢3.1接口描述通過接口可以方便的查詢你的賬戶剩余條數(shù)。內(nèi)容格式為：Content-Type:application/x-www-form-urlencoded3.2請求地址/idcard/GetNum.json3.3請求參數(shù)參數(shù)名稱參數(shù)值描述必填accountAPIID（用戶中心【實名認證】-【產(chǎn)品總覽】查看）是password1、APIKEY（用戶中心【實名認證】-【產(chǎn)品總覽】查看）2、動態(tài)密碼（生成動態(tài)密碼方式請看該文檔末尾的說明）是appid2是timeUnix時間戳（10位整型數(shù)字，當(dāng)使用動態(tài)密碼方式時為必填）否用戶通過http或https提交請求到服務(wù)器后，服務(wù)器會返回一串json格式的字符串，GetNumResult結(jié)構(gòu)說明如下：參數(shù)名稱類型描述codeint狀態(tài)返回值msgstring查詢結(jié)果描述numstring剩余數(shù)量3.4響應(yīng)示例示例（成功）{"code":2,"msg":"查詢成功","num":123}示例（失?。﹞"code":405,"msg":"用戶名或密碼不正確","num":0}3.5響應(yīng)參數(shù)codemsg2查詢成功400非法ip訪問401帳號不能為空402密碼不能為空403應(yīng)用不存在405APIID或APIKEY不正確4050賬號被凍結(jié)40501動態(tài)密碼已過期40502動態(tài)密碼校驗失敗4052訪問ip與備案ip不符3.6GET請求示例/idcard/GetNum.json&account=APIID&password=APIKEY&app=id24.生成動態(tài)密碼方式以PHP為例，提交認證的生成方式：$time=time();$password=md5($account.$apikey.$app.$name.$id_card_no.$time);示例：APIID：testAPIKEY：1q784322ba1******app：id2name：張三id_card_no：40122111******time：1651544941結(jié)果：$password=md5('test1q784322ba1******id2張三40122111******1651544941');注意：所以字符編碼統(tǒng)一為UTF-8查詢剩余條數(shù)的生成方式：$time=time();$password=md5($account.$apikey.$app.$time);示例：APIID：testAPIKEY：1q784322ba1******app：id2time：1651544941結(jié)果：$password=md5('test1q784322ba1******id21651544941');Unix時間戳參考地址：/Tools/unixtime.aspx5.如何實現(xiàn)UNIX時間戳語言代碼JAVAStringdate=newjava.text.SimpleDateFormat("dd/MM/yyyyHH:mm:ss").format(newjava.util.Date(Unixtimestamp*1000))Linuxdate-d@UnixtimestampCstrptime(datetime,"%Y-%m-%d%H:%M:%S",&tm_time);unixtime=mktime(&tm_time);C++std::time_tt=std::time(0);DELPHIusesDateUtils;DateTimeToUnix(Now)GOimport"time"cur:=time.Now()timestamp:=cur.UnixNano()/1000000Perl先my$time=Unixtimestamp然后my($sec,$min,$hour,$day,$month,$year)=(localtime($time))[0,1,2,3,4,5,6]PHPdate('r',Unixtimestamp)Node.jsvardate=newDate(time*1000);vartime=date.getTime()/1000;Python先importtime然后time.gmtime(Unixtimestamp)RubyTime.at(Unixtimestamp)SHELLdate+%s//UNIX的時間戳;VBScript/ASPDateAdd("s",Unixtimestamp,"01/01/197000:00:00")VB6DateDiff("s","1970-1-10:0:0",ToUnixTime)易語言時間_到時間戳（）6.DEMO示例語言DEMO地址PHP/demo/idcard2/php.htmlJAVA/demo/idcard2/java.htmlC++/demo/idcard2/cpp.htmlGO/demo/idcard2/go.htmlpython/demo/idcard2/python.html7.aes加密示例7.1PHP示例<?phpfunctionaes_encode($text){$key='APIKEY';$cipher="aes-256-cbc";$options=OPENSSL_RAW_DATA;$iv=substr(md5($key),8,16);$encrypted=openssl_encrypt($text,$cipher,$key,