身份证OCR识别接口文档

互亿无线身份证OCR识别API中国·上海4008808898互亿无线身份证OCR识别API接口说明文件标识Ihuyi_OCRAPI版本编号V1.1发布者上海思锐信息技术有限公司发布日期2022-09-09最新更新2023-10-08

目录 1.概要 31.1文档说明 31.2提交方式 31.3加密方式 31.4APIID/APIKEY 32.接交认证 32.1接口描述 32.2请求地址 32.3请求参数 42.4响应示例 42.5响应参数 52.6GET请求示例 63.余额查询 63.1接口描述 63.2请求地址 63.3请求参数 63.4响应示例 73.5响应参数 73.6GET请求示例 84.生成动态密码方式 85.如何实现UNIX时间戳 96.DEMO示例 97.联系方式 10

1.概要1.1文档说明本文档主要提供给互亿平台的用户对接接口的使用说明，开发者可以利用互亿无线提供的HTTP接口，调用互亿无线的OCR识别服务。1.2提交方式GET/POST1.3加密方式1、采用HTTPS协议提交请求2、通过MD5动态签名方式加密1.4APIID/APIKEY登录用户中心，进入【OCR识别】模块，在【产品总览】页面右侧，如下图所示：2.提交识别2.1接口描述通过POST、GET方式进行提交，数据编码采用utf-8格式，24小时全天提交。2.2请求地址/orc/Submit.json2.3请求参数参数名称参数值描述必填accountAPIID（用户中心【实名认证】-【产品总览】查看）是password1、APIKEY（用户中心【实名认证】-【产品总览】查看）2、动态密码（生成动态密码方式请看该文档末尾的说明）是appidcard是img_base64图片base64编码二选一（推荐使用img_url方式）是img_url图片URLtimeUnix时间戳（10位整型数字，当使用动态密码方式时为必填）否用户通过http或https提交请求到服务器后，服务器会返回一串json格式的字符串，SubmitResult结构说明如下：参数名称类型描述codeint返回值为2时，表示提交成功ocridstring当提交成功后，此字段为流水号，否则为0msgstring提交结果描述contentobject识别内容（字段详情分正面和反面）正面内容参数名称类型描述typestringfrontnamestring姓名id_numberstring身份证号genderstring性别ethnicitystring民族data_of_birthstring出生日期（YYYY.MM.DD）domicilestring住址反面内容参数名称类型描述typestringbackissue_authoritystring签发机关valid_periodstring有效期限（YYYY.MM.DD-YYYY.MM.DD）2.4响应示例示例（成功）{"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响应参数codemsg0未知错误1提交失败2提交成功400非法ip访问401帐号不能为空402密码不能为空403应用不存在404img_base64或img_url必须传一个405APIID或APIKEY不正确4050账号被冻结40501动态密码已过期40502动态密码校验失败40505没有签定合同4051剩余次数不足4052访问ip与备案ip不符4086图片错误4010通道错误2.6GET请求示例/ocr/Submit.json&account=APIID&password=APIKEY&app=idcard&img_url=/xxxx.png3.余额查询3.1接口描述通过接口可以方便的查询你的账户剩余次数。3.2请求地址/ocr/GetNum.json3.3请求参数参数名称参数值描述必填accountAPIID（用户中心【实名认证】-【产品总览】查看）是password1、APIKEY（用户中心【实名认证】-【产品总览】查看）2、动态密码（生成动态密码方式请看该文档末尾的说明）是appidcard是timeUnix时间戳（10位整型数字，当使用动态密码方式时为必填）否用户通过http或https提交请求到服务器后，服务器会返回一串json格式的字符串，GetNumResult结构说明如下：参数名称类型描述codeint状态返回值msgstring查询结果描述numstring剩余次数3.4响应示例示例（成功）{"code":2,"msg":"查询成功","num":123}示例（失败）{"code":405,"msg":"APIID或APIKEY不正确","num":0}3.5响应参数codemsg2查询成功400非法ip访问401帐号不能为空402密码不能为空403应用不存在405APIID或APIKEY不正确4050账号被冻结40501动态密码已过期40502动态密码校验失败4052访问ip与备案ip不符3.6GET请求示例/ocr/GetNum.json&account=APIID&password=APIKEY&app=idcard4.生成动态密码方式以PHP为例，提交认证的生成方式：$time=time();$password=md5($account.$apikey.$app.$img_base64.$img_url.$time);示例：APIID：testAPIKEY：1q784322ba1******app：idcardimg_base64：img_url：/xxx.pngtime：1651544941结果：$password=md5('test1q784322ba1******idcard/xxx.png1651544941');注意：所以字符编码统一为UTF-8查询剩余条数的生成方式：$time=time();$password=md5($account.$apikey.$app.$time);示例：APIID：testAPIKEY：1q784322ba1******app：idcardtime：1651544941结果：$password=md5('test1q784322ba1******idcard1651544941');Unix时间戳参考地址：/Tools/unixtime.aspx5.如何实现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/dem