驾驶证OCR

更新时间:2024-08-29 14:13:36

接口描述

上传驾驶证照片,并进行证件信息识别

接口

/v2/identity/auth/api/ocr/drivinglicence

请求方式

POST

请求头

提供两种安全接入方式,对应参数如何获取,参考文档【请点击】。

方式一:请求签名鉴权(优先推荐)

参数名称

类型

必选

参数说明

X-Tsign-Open-App-Id

string

项目ID

Content-Type

string

application/json;charset=UTF-8

X-Tsign-Open-Ca-Timestamp

string

API 调用者传递时间戳,值为当前时间的毫秒数,也就是从1970年1月1日起至今的时间转换为毫秒,时间戳有效时间为15分钟,为了防重放攻击

Accept

string

建议统一填写 */*

X-Tsign-Open-Ca-Signature

string

签名字符串

Content-MD5

string

当请求 Body 非 Form 表单时,可以计算 Body 的 MD5 值传递给云网关进行 Body MD5 校验。建议当请求 Body 非 Form 表单时,加上此请求头。

X-Tsign-Open-Auth-Mode

string

选择请求方式进行鉴权,固定值,Signature

方式二:OAuth2.0鉴权(不推荐使用)

当安全接入选择OAuth2.0鉴权方式请点击查阅详情。

请求参数

参数名称

类型

必选

参数类型

参数说明

image

string

body

驾驶证图片BASE64字符串

注意不要带图片BASE64前缀“data:image/jpeg;base64,”

图片类型支持:jpg,jpeg,png,bmp。

图片建议分辨率1024*768,图片大小控制在3M以内

backImage

string

body

驾驶证副页图片BASE64字符串

注意不要带图片BASE64前缀“data:image/jpeg;base64,”

图片类型支持:jpg,jpeg,png,bmp。

图片建议分辨率1024*768,图片大小控制在3M以内

requestId

string

body

请求id,标识一次客户的请求,允许为空,一般使用客户的业务id

响应参数

展开全部参数参数名称

类型

必选

参数说明

code

int

接口响应结果码

message

string

接口响应结果描述

data

object

接口响应结果数据

verifyId

string

业务Id

name

string

姓名

number

string

驾驶证号

type

string

证件类型

address

string

持证人住址

nationality

string

持证人国籍

issueDate

string

初次领证日期

sex

string

性别

birthday

string

持证人出生年月日

validTime

string

驾驶证有效期

driveType

string

准驾车型

fileNumber

string

档案编号

record

string

记录

issuingAuthority

string

发证机关

请求示例  

{
    "requestId":"123",
    "image": "/9j/4AAQSkZJRgABAQEAS......"
}

响应示例

{
    "code": 0,
    "message": "成功",
    "data": {
        "verifyId": "ef291116-0001-41a3-8caa-7c4a6db7a179",
        "birthday": "1996-03-12",
        "issueDate": "2013-11-12",
        "issuingAuthority": "XXXXXXXX公安局交通警察支队",
        "sex": "女",
        "address": "XXXXXXXX",
        "nationality": "中国",
        "name": "张三",
        "validTime": "2020-08-13至2030-08-13",
        "driveType": "C1",
        "type": "中华人民共和国机动车驾驶证",
        "number": "2311XXXXXXXXX",
        "fileNumber": "23XXXXXXX7",
        "record": ""
    }
}

错误码

错误码

错误描述

解决方案

30500101

参数错误:image不能为空

图片BASE64字符串为空

30503127

OCR识别失败

OCR识别失败


我要纠错