身份證OCR識(shí)別接口文檔

互億無線身份證OCR識(shí)別API中國·上海4008808898互億無線身份證OCR識(shí)別API接口說明文件標(biāo)識(shí)Ihuyi_OCRAPI版本編號(hào)V1.1發(fā)布者上海思銳信息技術(shù)有限公司發(fā)布日期2022-09-09最新更新2023-10-08

目錄 1.概要 31.1文檔說明 31.2提交方式 31.3加密方式 31.4APIID/APIKEY 32.接交認(rèn)證 32.1接口描述 32.2請(qǐng)求地址 32.3請(qǐng)求參數(shù) 42.4響應(yīng)示例 42.5響應(yīng)參數(shù) 52.6GET請(qǐng)求示例 63.余額查詢 63.1接口描述 63.2請(qǐng)求地址 63.3請(qǐng)求參數(shù) 63.4響應(yīng)示例 73.5響應(yīng)參數(shù) 73.6GET請(qǐng)求示例 84.生成動(dòng)態(tài)密碼方式 85.如何實(shí)現(xiàn)UNIX時(shí)間戳 96.DEMO示例 97.聯(lián)系方式 10

1.概要1.1文檔說明本文檔主要提供給互億平臺(tái)的用戶對(duì)接接口的使用說明，開發(fā)者可以利用互億無線提供的HTTP接口，調(diào)用互億無線的OCR識(shí)別服務(wù)。1.2提交方式GET/POST1.3加密方式1、采用HTTPS協(xié)議提交請(qǐng)求2、通過MD5動(dòng)態(tài)簽名方式加密1.4APIID/APIKEY登錄用戶中心，進(jìn)入【OCR識(shí)別】模塊，在【產(chǎn)品總覽】頁面右側(cè)，如下圖所示：2.提交識(shí)別2.1接口描述通過POST、GET方式進(jìn)行提交，數(shù)據(jù)編碼采用utf-8格式，24小時(shí)全天提交。2.2請(qǐng)求地址/orc/Submit.json2.3請(qǐng)求參數(shù)參數(shù)名稱參數(shù)值描述必填accountAPIID（用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看）是password1、APIKEY（用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看）2、動(dòng)態(tài)密碼（生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明）是appidcard是img_base64圖片base64編碼二選一（推薦使用img_url方式）是img_url圖片URLtimeUnix時(shí)間戳（10位整型數(shù)字，當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填）否用戶通過http或https提交請(qǐng)求到服務(wù)器后，服務(wù)器會(huì)返回一串json格式的字符串，SubmitResult結(jié)構(gòu)說明如下：參數(shù)名稱類型描述codeint返回值為2時(shí)，表示提交成功ocridstring當(dāng)提交成功后，此字段為流水號(hào)，否則為0msgstring提交結(jié)果描述contentobject識(shí)別內(nèi)容（字段詳情分正面和反面）正面內(nèi)容參數(shù)名稱類型描述typestringfrontnamestring姓名id_numberstring身份證號(hào)genderstring性別ethnicitystring民族data_of_birthstring出生日期（YYYY.MM.DD）domicilestring住址反面內(nèi)容參數(shù)名稱類型描述typestringbackissue_authoritystring簽發(fā)機(jī)關(guān)valid_periodstring有效期限（YYYY.MM.DD-YYYY.MM.DD）2.4響應(yīng)示例示例（成功）{"code":2,"msg":"提交成功","ocrid":"22101320041348318","content":{"type":"back","issue_authority":"上海市公安局徐匯分局","valid_period":"2005.10.08-2025.10.08"}}示例（失?。﹞"code":405,"msg":"APIID或APIKEY不正確","ocrid":"0","content":{}}2.5響應(yīng)參數(shù)codemsg0未知錯(cuò)誤1提交失敗2提交成功400非法ip訪問401帳號(hào)不能為空402密碼不能為空403應(yīng)用不存在404img_base64或img_url必須傳一個(gè)405APIID或APIKEY不正確4050賬號(hào)被凍結(jié)40501動(dòng)態(tài)密碼已過期40502動(dòng)態(tài)密碼校驗(yàn)失敗40505沒有簽定合同4051剩余次數(shù)不足4052訪問ip與備案ip不符4086圖片錯(cuò)誤4010通道錯(cuò)誤2.6GET請(qǐng)求示例/ocr/Submit.json&account=APIID&password=APIKEY&app=idcard&img_url=/xxxx.png3.余額查詢3.1接口描述通過接口可以方便的查詢你的賬戶剩余次數(shù)。3.2請(qǐng)求地址/ocr/GetNum.json3.3請(qǐng)求參數(shù)參數(shù)名稱參數(shù)值描述必填accountAPIID（用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看）是password1、APIKEY（用戶中心【實(shí)名認(rèn)證】-【產(chǎn)品總覽】查看）2、動(dòng)態(tài)密碼（生成動(dòng)態(tài)密碼方式請(qǐng)看該文檔末尾的說明）是appidcard是timeUnix時(shí)間戳（10位整型數(shù)字，當(dāng)使用動(dòng)態(tài)密碼方式時(shí)為必填）否用戶通過http或https提交請(qǐng)求到服務(wù)器后，服務(wù)器會(huì)返回一串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":"APIID或APIKEY不正確","num":0}3.5響應(yīng)參數(shù)codemsg2查詢成功400非法ip訪問401帳號(hào)不能為空402密碼不能為空403應(yīng)用不存在405APIID或APIKEY不正確4050賬號(hào)被凍結(jié)40501動(dòng)態(tài)密碼已過期40502動(dòng)態(tài)密碼校驗(yàn)失敗4052訪問ip與備案ip不符3.6GET請(qǐng)求示例/ocr/GetNum.json&account=APIID&password=APIKEY&app=idcard4.生成動(dòng)態(tài)密碼方式以PHP為例，提交認(rèn)證的生成方式：$time=time();$password=md5($account.$apikey.$app.$img_base64.$img_url.$time);示例：APIID：testAPIKEY：1q784322ba1******app：idcardimg_base64：img_url：/xxx.pngtime：1651544941結(jié)果：$password=md5('test1q784322ba1******idcard/xxx.png1651544941');注意：所以字符編碼統(tǒng)一為UTF-8查詢剩余條數(shù)的生成方式：$time=time();$password=md5($account.$apikey.$app.$time);示例：APIID：testAPIKEY：1q784322ba1******app：idcardtime：1651544941結(jié)果：$password=md5('test1q784322ba1******idcard1651544941');Unix時(shí)間戳參考地址：/Tools/unixtime.aspx5.如何實(shí)現(xiàn)UNIX時(shí)間戳語言代碼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的時(shí)間戳;VBScript/ASPDateAdd("s",Unixtimestamp,"01/01/197000:00:00")VB6DateDiff("s","1970-1-10:0:0",ToUnixTime)易語言時(shí)間_到時(shí)間戳（）6.DEMO示例語言DEMO地址PHP/dem