图片大小最大限制2M
https://ai.inspirvision.cn/s/api/ocr/identityCard
post
multipart/form-data
需要通过鉴权token接口获取token发起该请求
是否必选
参数名
类型
参数说明
必选
token
string
通过调用获取鉴权接口获得
必选（三选一）
file
file
图片文件需要使用post multipart/form-data的方式上传
imgUrl
string
图片的URL地址
img
string
图片编码(包含data:image/png;,)；生产环境请优先考虑使用该参数传图片
非必选
cropType
int
身份证类型：0=实拍身份证图片，1=身份证正反面复印件图片；默认为 0
非必选
detectQuality
int
是否开启身份证质量类型(清晰模糊、边框/四角不完整、头像或关键字段被遮挡/马赛克)检测功能：0=不开启，1=开启；默认为 0
非必选
detectRisk
int
是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)检测功能：0=不开启，1=开启；默认为 0
参数名
参数类型
参数描述
status
int
200：成功 其他：业务异常
data
对象
执行成功时data有对象值，执行异常时不返回data
serialNo
string
日志ID
message
string
提示信息
code
int
业务码参考资源表
参数名
参数类型
参数描述
name
string
姓名
sex
string
性别
nation
string
民族
birthday
string
出生日期；例：1976-11-20
address
string
住址
idNo
string
身份证号
issuedBy
string
签发机关（国徽面）
validDate
string
有效期限（国徽面）
riskType
string
身份证风险类型：1.normal-正常身份证；2.copy-复印件；3.temporary-临时身份证；4.screen-翻拍；5.unknown-其他未知情况
detectRisk
Object
身份证质量类型
参数名
参数类型
参数描述
IsClear
string
质量类型，是否清晰
IsClear_propobility
string
“是否清晰”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好， IsClear_propobility 超过0.5时，对应 IsClear 返回1，低于0.5，则返回0，具体业务场景可以根据该值设置是否清晰
IsComplete
string
质量类型，是否边框/四角完整
IsComplete_propobility
string
“是否边框/四角完整”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好，IsComplete_propobility 超过0.5时，对应 IsComplete 返回1，低于0.5，则返回0，具体业务场景可以根据该值设置是否完整
IsNoCover
string
质量类型，是否头像、关键字段无遮挡/马赛克
IsNoCover_propobility
string
“是否头像、关键字段无遮挡/马赛克”质量类型对应的概率，值在0-1之间，值越大表示图像质量越好。当 IsNoCover_propobility 超过0.3时，对应IsNoCover 返回1，低于0.3，则返回0，具体业务场景可以根据该值设置是否遮挡
{ "status": 200, "code": 0, "message": "success", "serialNo": "345388940666077184", "data": { "name": "罗芳红", "sex": "女", "nation": "汉", "birthday": "1998-11-1", "address": "云南省玉溪市红塔区凤凰街道瓦窑村114幢140号", "idNo": "530402199811012844", "issuedBy": null, "validDate": null } }
{ "serialNo": "343841871253995520", "message": "检测身份证失败,请上传正确的身份证图片", "status": 400, "code": 3000 }
HTTP 状态代码
错误信息
400
业务异常，具体message提示。
401
身份验证失败（token过期或非法账号）
402
未开通产品权限；或者产品次数不足
403
权限不足
404
请求路径不存在
413
客户发送的请求大小超过了2MB限制。
500
系统内部异常
502
网关异常
身份证人脸比对：
企事业单位、金融机构等实体组织在获取信息主体（持证人）授权的基础上，上传姓名+身份证+照片，返回置信度。支持全国境内持证人的身份证信息验证。总体验证成功率99.99%，系统并发上限为500笔/秒，系统响应速度平均500ms。
调用URL
https://ai.inspirvision.cn/s/api/ocr/cloudCode/IdCard
post
multipart/form-data
需要通过鉴权token接口获取token发起该请求
是否必选
参数名
类型
参数说明
必选
token
string
通过调用获取鉴权接口获得
必选
idCard
string
身份证号
必选
realName
string
姓名
参数名
参数类型
参数描述
status
int
200：成功 400：业务异常
serialNo
string
日志ID
message
string
提示信息
code
int
业务码
{ "code": 10000, "status": 200, "message": "验证通过", "serialNo": "3a08706326623594479616" }
{ "code": 10064, "status": 400, "message": "验证不通过", "serialNo": "3a08706655540649918464" }
通用的ERROR_MESSAGE
HTTP 状态代码
错误信息
400
业务异常，具体message提示。
401
身份验证失败（token过期或非法账号）
402
未开通产品权限；或者产品次数不足
403
权限不足
404
请求路径不存在
413
客户发送的请求大小超过了2MB限制。
500
系统内部异常
502
网关异常
返回搜狐，查看更多
Skylake微架构
搜索 阿凡达 共找到 2 部