You need to enable JavaScript to run this app.
导航
个人卡证识别
  • 文档首页
    • /
  • 个人卡证识别

接口文档

最近更新时间：2021.12.16 13:59:15

首次发布时间：2021.12.16 13:59:15

我的收藏

接入指引#

请先查看接入指引了解具体接入方式，再参考此文档完成接入。

请求API

名称内容
请求方式POST
Content-Typeapplication/x-www-form-urlencoded (传入参数不包含类型File)
multipart/form-data (参数包含类型File)
是否需要鉴权是
图片要求1. 图片格式：JPG、JPEG、PNG、BMP等常见格式，建议使用JPG格式。
2. 图片像素尺寸：最小 256 x 256 像素，最大 2048 x 2048 像素。为了保证文字识别效果，推荐图片中行驶证最短边长不低于256像素。
3. 图片文件大小：最大 4 MB。行驶证主体尽量占据图片主要区域，不支持黑白图片。
4. 注意图片质量：保证行驶证图片足够清晰，不应该有因为压缩导致的噪声，避免对行驶证正反面的遮挡、不当的光照（强光、暗光、逆光）等，否则会降低结果准确度。
5. 图片需要有版权，有肖像权，没有法律或者政策风险的。相关风险请注意评估。
6. 行驶证图片不可以是复印件、翻拍件、PS件等。

输入参数

Query参数：

参数可选/必选类型说明
Action必选String接口名，取值：VehicleLicense
Version必选String版本号，取值：2020-08-26

Body参数：

参数可选/必选类型说明
image_base64必选（image和image_base64必须二选一，都有的情况仅使用image）String行驶证图片文件，base64编码

API返回

通用返回字段说明

请参考通用返回字段及错误码

data 字段说明

字段类型说明备注
license_mainmain_info主页面信息字段说明见下方

main_info 字段说明

字段类型说明备注
plate_numberString号码号牌主页信息
vehicle_typeString车辆类型主页信息
ownerString所有人主页信息
addressString住址主页信息
use_characterString使用性质主页信息
modelString品牌型号主页信息
vinString车辆识别代号主页信息
engine_numberString发动机号码主页信息
register_dateString注册日期(YYYY.MM.DD)主页信息
issue_dateString发证日期(YYYY.MM.DD)主页信息

错误码示例

HttpCode错误码错误消息描述
20010000无请求成功
40060403"Invalid Input Image: No vehicle license detected in input image, bad input image"输入图片没有检测到行驶证
40150205"Image Size Exceeds Maximum Limit: please compress the image"图片大小超过上限
40050207"Image Decode Error: image format unsupported"图片解码错误，文件内容为空或格式错误
40150400"Access denied due to invalid authentication information"鉴权失败
40450402"Invalid Request URL"无效的请求路径
50050500"Internal Error: please contact with bytedance engineering team"内部错误，需要联系开发人员

返回值示例

主页面图片返回值示例

{
    "code": 10000,
    "data":{
        "license_main":{
            "plate_number": "豫A99XXX",
            "vehicle_type": "小型普通客车",
            "owner":"鲁XX",
            "address":"江苏省滨海县XX镇XX路X号",
            "use_character":"非营运",
            "model":"别克牌SGKXXXXLAAT"
            "vin": "SSVUDDTT2J2000000",
            "engine_number": "111000",
            "issue_date": "2010.01.01",
            "register_date": "2010.01.02"
        }
    },
    "message": "Success",
    "request_id": "6838885791079335947",
    "time_elapsed": "791.12641ms"
}