车辆维保记录查询API分为以下几个子接口:
1. 维保记录下单接口
通过提交车辆 VIN 码(部分品牌需附加发动机号),快速创建维保记录查询订单,支持 GET/POST 请求。
2. 维保记录订单查询接口
通过订单号实时追踪查询状态(进行中 / 成功 / 失败),获取结构化维保数据,涵盖保养内容、部件、时间及车辆损伤历史。
3.品牌支持列表接口
提供可查询的品牌清单及对应价格,帮助企业提前确认目标车辆是否在服务范围内。
通过维保记录查询,实时获取车辆是否有重大事故维修、泡水火烧历史,解决买卖双方信息不对称问题提升交易转化率。
针对新能源品牌(如特斯拉、比亚迪),通过发动机号(部分车型)+VIN 码精准查询三电系统(电池、电机、电控)保养记录,助力电池衰减评估与维修决策。
投保前通过 API 查询历史出险维修记录,对比当前车况,识别 “泡水车翻新”“过度维修” 等骗保行为,提升核保效率 30%+。
以维保记录下单接口为例
请求URL
http://api.tanshuapi.com/api/car_care/v1/index?key=&vin=WAUAFEF58JA036323&engine=
请求方式
GET POST
参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
vin | 是 | string | vin码 |
notify_url | 否 | string | 回调URL |
engine | 否 | string | 发动机号 |
plate | 否 | string | 车牌号 |
JSON 返回示例
{
"code": 1,
"msg": "操作成功",
"data": {
"vin": "WAUAFEF58JA036323",
"brand_id": 49,
"price": 38,
"order_id": "a53a44a266aae69fe8b11b32e85bce88"
}
}
Java 代码示例
import okhttp3.MediaType;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.RequestBody;
import okhttp3.Response;
import java.io.IOException;
public class CarCareOrderPlacement {
private static final OkHttpClient client = new OkHttpClient();
private static final String API_URL = "http://api.tanshuapi.com/api/car_care/v1/index";
private static final String API_KEY = "YOUR_API_KEY"; // 替换为个人中心获取的有效密钥
private static final String VIN = "WAUAFEF58JA036323"; // 目标车辆VIN码
private static final String ENGINE = ""; // 可选参数:部分品牌需提供发动机号(示例中为空)
public static void main(String[] args) {
// 构建请求体(POST方法)
MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
String body = "key=" + API_KEY + "&vin=" + VIN + "&engine=" + ENGINE;
RequestBody requestBody = RequestBody.create(mediaType, body);
Request request = new Request.Builder()
.url(API_URL)
.post(requestBody) // 使用POST方法提交订单
.build();
try (Response response = client.newCall(request).execute()) {
if (!response.isSuccessful()) {
System.out.println("下单失败,状态码:" + response.code());
return;
}
String responseBody = response.body().string();
System.out.println("下单结果:\n" + responseBody);
// 解析关键信息(示例:提取订单号和品牌ID)
// 实际开发中建议使用JSON解析库(如Gson/Jackson)
// 示例逻辑:假设responseBody为上述JSON格式
// String orderId = ...; // 从JSON中提取order_id
} catch (IOException e) {
e.printStackTrace();
System.out.println("网络请求异常:" + e.getMessage());
}
}
}
无论是二手车平台、保险公司,还是维修企业、汽车电商,该 API 均为构建核心竞争力的底层技术支撑,助力企业在 2025 年汽车后市场的蓝海中实现降本增效与合规运营。