ShowAPI,互联网API入口
立即注册

OCR身份证识别 官方自营 全部收费

上传身份证图片,来识别图片中的姓名、性别、身份证号码、地址、发证机关、有效期等信息

累计调用

479万+
价格: 0.01元起

接口说明/ API Explain

上传身份证图片,来识别图片中的姓名、性别、身份证号码、地址、发证机关、有效期等信息

接入点说明:
 身份证识别
相关文档:
接口地址: http://route.showapi.com/1429-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

查看加密签名方式 请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
imgData String
身份证图片的base64信息
type String 1
身份证的正面或反面,正面1 反面2,默认值为1

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
name String
姓名
sex String
性别
nationality String
民族
birthday String
生日
addr String
地址
idNo String
身份证号码
headImgBase64 String
身份证图像的base64
depInfo String
签发部门
effDate String
有效期的起始日期
effBeginDate String
签发日期
effEndDate String
有效期的截止日期
ret_code String
0
接口调用是否成功,0为成功,其他为失败
flag String
true
业务请求是否成功
msg String
识别成功!
提示信息
...

返回示例/ Return example

{
    "showapi_res_code": 0, 
    "showapi_res_error": "", 
    "showapi_res_body": {
        "msg": "识别成功!", 
        "birthday": "198X-0X-XX", 
        "flag": true, 
        "nationality": "汉", 
        "sex": "男", 
        "name": "王XX", 
        "headImgBase64": "若需要该字段值请使用身份证识别返照接口", 
        "addr": "湖北省武汉市.....", 
        "ret_code": 0, 
        "idNo": "*********01211122"
    }
}