API文档
车辆里程表识别API使用说明
API概览
基础URL: https://lcy.tunhaisz.com
认证方式: Bearer Token
POST
/api/token
用户登录获取访问令牌
请求参数:
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| username | string | 是 | 手机号码 |
| password | string | 是 | 密码 |
响应示例:
{
"status": "success",
"data": {
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"token_type": "bearer"
},
"msg": "成功"
}
GET
/api/usage/quota
获取用户使用配额
请求头:
Authorization: Bearer <access_token>
响应示例:
{
"status": "success",
"data": {
"used": 34,
"remaining": 66,
"total": 100
},
"msg": "成功"
}
POST
/api/mileage/recognize
里程表图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 里程表图片文件 |
响应示例:
{
"status": "success",
"data": {
"mileage": 85602,
"confidence": 0.92
},
"msg": "识别成功"
}
POST
/api/vehicle-reg/recognize
车辆登记证图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 车辆登记证图片文件 |
响应示例:
{
"status": "success",
"data": {
"document_type": "机动车登记证书",
"registration_id": "350010039447",
"registration_summary": {
"owner": {
"name": "张三",
"id_type": "居民身份证",
"id_number": "350211199101183651"
},
"registration_authority": "福建省厦门市公安局交通警察支队",
"registration_date": "2020-05-07",
"vehicle_registration_number": "闽D12345"
},
"transfer_records": [{
"sequence": "I",
"owner": {
"name": "李四",
"id_type": "居民身份证",
"id_number": "350211198706168418"
},
"registration_authority": "福建省厦门市公安局交通警察支队",
"registration_date": "2022-08-15",
"vehicle_registration_number": "闽D67890"
}],
"vehicle_information": {
"vehicle_type": "小型轿车",
"brand": "大众汽车牌",
"model": "SVW71612BS",
"vin": "LSVAG2182E2123456",
"engine_number": "123456",
"fuel_type": "汽油",
"manufacture_date": "2020-01-15",
"manufacturer": "上汽大众汽车有限公司",
"color": "白色",
"origin": "国产",
"engine_model": "",
"displacement_power": {
"displacement_ml": 1598,
"power_kw": 81,
"unit": "kw",
"value": 81
},
"steering_form": "方向盘",
"tire_count": 4,
"spring_type": 3,
"wheelbase": {
"front": 1500,
"rear": 1500,
"unit": "mm"
},
"tire_specification": "205/55R16",
"axle_count": 2,
"dimensions": {
"length": 4600,
"width": 1780,
"height": 1460,
"unit": "mm"
},
"cargo_compartment_dimensions": {
"length": 0,
"width": 0,
"height": 0,
"unit": "mm"
},
"total_mass": 1800,
"rated_load_mass": 0,
"approved_passengers": 5,
"approved_towing_mass": 0,
"driver_cabin_seats": 2,
"usage_character": "非营运",
"acquisition_method": "购买"
},
"issuing_authority": {
"stamp": "福建省厦门市公安局交通警察支队",
"issue_date": "2020-05-07"
}
},
"msg": "识别成功"
}
POST
/api/vehicle-reg-back/recognize
车辆登记证副业图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 车辆登记证副业图片文件 |
响应示例:
{
"status": "success",
"data": {
"certificate_number": "350010039447",
"registrations": [{
"registration_id": 1,
"registration_info": [{
"entry_number": 1,
"registration_type": "抵押登记",
"content": "抵押登记"
},
{
"entry_number": 2,
"registration_type": "抵押权人姓名/名称",
"content": "青岛瑞祥天下融资租赁有限公司"
},
{
"entry_number": 3,
"registration_type": "身份证明名称/号码",
"content": "统一社会信用代码/91370200MA3CJ8AA48"
},
{
"entry_number": 4,
"registration_type": "抵押登记日期",
"content": "2020-05-07"
}]
}]
},
"msg": "识别成功"
}
POST
/api/driving-license/recognize
驾驶证图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 驾驶证图片文件 |
响应示例:
{
"status": "success",
"data": {
"idNumber": "110101199001011234",
"name": "张三",
"gender": "男",
"nationality": "中国",
"address": "北京市朝阳区xxx街道xxx号",
"dateOfBirth": "1990-01-01",
"firstIssueDate": "2020-01-01",
"validFrom": "2020-01-01",
"validUntil": "2030-01-01",
"licenseClass": "C1",
"status": "正常",
"violationPoints": "0分",
"issuingAuthority": "北京市公安局公安交通管理局",
"archiveNumber": "110000123456",
"licenseType": "Normal",
"generateTime": "",
"currentTime": "",
"record": ""
},
"msg": "识别成功"
}
POST
/api/vehicle-license/recognize
行驶证主页图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 行驶证主页图片文件 |
响应示例:
{
"status": "success",
"data": {
"document_type": "中华人民共和国机动车行驶证",
"plate_number": "京A12345",
"vehicle_type": "小型轿车",
"owner": "张三",
"address": "北京市朝阳区xxx街道xxx号",
"use_character": "非营运",
"brand_model": "大众汽车牌SVW71612BS",
"vin": "LSVAG2182E2123456",
"engine_number": "123456",
"register_date": "2020-01-01",
"issue_date": "2020-01-01",
"issuing_authority": "北京市公安局公安交通管理局"
},
"msg": "识别成功"
}
POST
/api/compulsory-insurance/recognize
交强险保单图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 交强险保单图片文件 |
响应示例:
{
"status": "success",
"data": {
"policy_type": "机动车交通事故责任强制保险单",
"insurer_name": "中国人民财产保险股份有限公司",
"insurer_branch": "北京市分公司",
"policy_number": "PDZA202411010000123456",
"issue_date": "2024-01-01",
"start_date": "2024-01-01T00:00:00",
"end_date": "2025-01-01T23:59:59",
"premium_total": "950.00",
"premium_base": "896.23",
"premium_tax": "53.77",
"floating_rate": "-10",
"insured": {
"name": "张三",
"id_type": "身份证",
"id_number": "110101199001011234",
"address": "北京市朝阳区xxx街道xxx号",
"phone": "13800138000"
},
"vehicle": {
"plate_number": "京A12345",
"engine_number": "123456",
"vin": "LFV2A21K8E4567890",
"brand_model": "大众汽车牌SVW71612BS",
"vehicle_type": "6座以下客车",
"usage_type": "家庭自用汽车",
"seats": "5",
"load_capacity": "0",
"displacement": "1.6",
"power": "81",
"register_date": "2020-01-01",
"total_mass": "1500"
},
"coverage_limits": {
"death_disability": "180000",
"medical_expenses": "18000",
"property_damage": "2000",
"uninsured_death_disability": "18000",
"uninsured_medical_expenses": "1800",
"uninsured_property_damage": "100"
},
"tax_info": {
"current_year_premium": "360.00",
"previous_year_refund": "0.00",
"arrears": "0.00",
"total_amount": "360.00",
"tax_certificate_number": "110101202400012345",
"tax_authority": "国家税务总局北京市朝阳区税务局"
}
},
"msg": "识别成功"
}
POST
/api/commercial-insurance/recognize
商业险保单图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 商业险保单图片文件 |
响应示例:
{
"status": "success",
"data": {
"policy_info": {
"policy_number": "PDAA202411010000123456",
"insurance_company": "中国人民财产保险股份有限公司",
"policy_type": "机动车商业保险"
},
"applicant_name": "张三",
"insured_party": {
"name": "张三",
"id_type": "身份证",
"id_number": "110101199001011234",
"contact_phone": "13800138000",
"address": "北京市朝阳区xxx街道xxx号"
},
"vehicle_info": {
"plate_number": "京A12345",
"vin": "LFV2A21K8E4567890",
"engine_number": "123456",
"brand_model": "大众汽车牌SVW71612BS",
"vehicle_type": "客车",
"usage": "家庭自用汽车",
"seats": "5",
"load_capacity": "0",
"initial_registration_date": "2020-01-01",
"driving_license_holder": "张三"
},
"coverage_items": [{
"coverage_name": "机动车第三者责任保险",
"limit": "1000000",
"premium": "1200.00",
"deductible_rate": 0,
"is_main_coverage": true
},
{
"coverage_name": "机动车损失保险",
"limit": "158000",
"premium": "1850.20",
"deductible_rate": 0,
"is_main_coverage": true
}],
"policy_terms": {
"start_date": "2024-01-01 00:00:00",
"end_date": "2025-01-01 23:59:59"
},
"financial_summary": {
"total_premium_excluding_tax": "2800.00",
"tax_amount": "280.00",
"total_premium": "3080.00"
},
"company_info": {
"company_name": "中国人民财产保险股份有限公司",
"branch_name": "北京市分公司",
"address": "北京市东城区朝阳门北大街17号",
"contact_phone": "010-12345678",
"signing_date": "2024-01-01"
}
},
"msg": "识别成功"
}
POST
/api/vehicle-vin/recognize
车辆 VIN 码图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | VIN码图片文件 |
响应示例:
{
"status": "success",
"data": {
"vin": "LSVAG2182E2123456"
},
"msg": "识别成功"
}
POST
/api/vehicle-plate/recognize
车牌号图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 车牌图片文件 |
响应示例:
{
"status": "success",
"data": {
"plate_number": "京A12345"
},
"msg": "识别成功"
}
POST
/api/idcard_person/recognize
身份证人像面图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 身份证人像面图片文件 |
响应示例:
{
"status": "success",
"data": {
"name": "张三",
"gender": "男",
"ethnicity": "汉",
"date_of_birth": "1990-01-01",//格式YYYY-MM-DD
"address": "北京市朝阳区xxx街道xxx号",
"id_number": "110101199001011234"
},
"msg": "识别成功"
}
POST
/api/idcard_badge/recognize
身份证国徽面图片识别接口
请求头:
Authorization: Bearer <access_token>
请求参数 (multipart/form-data):
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| file | file | 是 | 身份证国徽面图片文件 |
响应示例:
{
"status": "success",
"data": {
"issueAuthority": "北京市公安局朝阳分局",
"validFrom": "2017-11-01",//格式YYYY-MM-DD
"validTo": "2047-11-01"//格式YYYY-MM-DD，若为长期，则返回"长期"
},
"msg": "识别成功"
}
使用示例
# 0. 用户登录
curl -X POST "https://lcy.tunhaisz.com/api/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "username=13800138000&password=your_password"
# 1. 查看使用配额
curl "https://lcy.tunhaisz.com/api/usage/quota" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
# 2. 里程表识别
curl -X POST "https://lcy.tunhaisz.com/api/mileage/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@mileage_image.jpg"
# 3. 电子保险单识别
curl -X POST "https://lcy.tunhaisz.com/api/insurance/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@insurance_image.jpg"
# 4. 登记证识别
curl -X POST "https://lcy.tunhaisz.com/api/vehicle-reg/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@vehicle_reg_image.jpg"
# 5. 登记证副业识别
curl -X POST "https://lcy.tunhaisz.com/api/vehicle-reg-back/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@registration_back_image.jpg"
# 6. 驾驶证识别
curl -X POST "https://lcy.tunhaisz.com/api/driving-license/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@driving_license_image.jpg"
# 7. 行驶证识别
curl -X POST "https://lcy.tunhaisz.com/api/vehicle-license/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@vehicle_license_image.jpg"
# 8. 交强险保单识别
curl -X POST "https://lcy.tunhaisz.com/api/compulsory-insurance/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@compulsory_insurance_image.jpg"
# 9. 商业险保单识别
curl -X POST "https://lcy.tunhaisz.com/api/commercial-insurance/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@commercial_insurance_image.jpg"
#10. 车辆VIN识别
curl -X POST "https://lcy.tunhaisz.com/api/vehicle-vin/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@vin_image.jpg"
#11. 车牌号识别
curl -X POST "https://lcy.tunhaisz.com/api/vehicle-plate/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@plate_image.jpg"
#12. 身份证人像面识别
curl -X POST "https://lcy.tunhaisz.com/api/idcard_person/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@idcard_front.jpg"
#13. 身份证国徽面识别
curl -X POST "https://lcy.tunhaisz.com/api/idcard_badge/recognize" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -F "file=@idcard_back.jpg"