二手车车辆详情查询 API（usedcar.detail）

# 用 usedcar.list 返回的车辆 dataId 拉取该车辆完整详情（含图片集）
curl -s -G "https://api.xujian.tech/openapi/usedcar/detail" \
  --data-urlencode "dataId=60323428" \
  -H "X-API-Key: 你的APIKey"

{
  "code": 0,
  "msg": "success",
  "data": {
    "dataId": "60323428",
    "infoid": 60323428,
    "carname": "大众迈腾 2021款 330TSI DSG 豪华型",
    "brandname": "大众",
    "seriesname": "大众迈腾",
    "specname": "2021款 330TSI DSG 豪华型",
    "cid": 500100,
    "cname": "重庆",
    "pid": 500000,
    "countyname": "",
    "engine": "2.0T",
    "gearbox": "自动",
    "mileage": 3.20,
    "price": 12.80,
    "downpayment": 3.80,
    "isloan": 1,
    "transfercount": 0,
    "firstregshortdate": "2021-06-01",
    "firstregdate": "2021-06",
    "firstregyear": "2021年",
    "firstregstr": "4年",
    "environmental": "国VI",
    "examine": "2027-6",
    "insurance": "2026-6",
    "colorname": "黑色",
    "carusename": "家用",
    "fuelname": "汽油",
    "drivingmode": "前置前驱",
    "levelname": "中型车",
    "flowmode": "涡轮增压",
    "marketrelative": "低于市场价3.50%",
    "dealerid": 142990,
    "remark": "【示例车商】车辆描述由车商自行发布，可能包含服务承诺、金融方案与门店信息等内容，长度不固定。",
    "videourl": "",
    "imageurl": "https://example.com/car/magotan-cover.jpg.webp",
    "piclist": [
      "https://example.com/car/magotan-1.jpg.webp",
      "https://example.com/car/magotan-2.jpg.webp",
      "https://example.com/car/magotan-3.jpg.webp"
    ],
    "catepiclist": [
      {
        "title": "外观",
        "list": [
          "https://example.com/car/magotan-1.jpg.webp",
          "https://example.com/car/magotan-2.jpg.webp"
        ]
      },
      {
        "title": "内饰",
        "list": [
          "https://example.com/car/magotan-3.jpg.webp"
        ]
      }
    ],
    "archivelist": [
      {"name": "上牌时间", "value": "2021-06"},
      {"name": "表显里程", "value": "3.20万公里"},
      {"name": "过户次数", "value": "0次"},
      {"name": "所在地区", "value": "重庆"}
    ],
    "archivebottomlistexp1": [
      {"name": "驱动方式", "value": "前置前驱"},
      {"name": "变速箱", "value": "7挡双离合"},
      {"name": "综合油耗", "value": "6.6L"},
      {"name": "发动机", "value": "2.0T"}
    ],
    "apiCode": "usedcar.detail",
    "apiName": "二手车车辆详情查询",
    "chargeType": "PER_CALL",
    "balance": 99.8000,
    "costMs": 520
  }
}

{
  "code": 500,
  "msg": "dataId 不能为空（取 usedcar.list 返回的车辆 dataId）",
  "data": null
}

{
  "code": 500,
  "msg": "未查询到该车辆的详情信息，请核对 dataId 后重试；本次调用不计费",
  "data": null
}

String body = HttpRequest.get("https://api.xujian.tech/openapi/usedcar/detail")
        .form("dataId", "60323428")
        .header("X-API-Key", apiKey)
        .timeout(15000)
        .execute()
        .body();

JSONObject json = JSONUtil.parseObj(body);
if (json.getInt("code") != 0) {
    System.out.println("查询失败（不收费）：" + json.getStr("msg"));
    return;
}
JSONObject data = json.getJSONObject("data");
System.out.println("车型：" + data.getStr("carname"));
System.out.println("里程：" + data.getBigDecimal("mileage") + " 万公里");
System.out.println("售价：" + data.getBigDecimal("price") + " 万元");
System.out.println("首付：" + data.getBigDecimal("downpayment") + " 万元");
System.out.println("图片数：" + data.getJSONArray("piclist").size());
// 分类图集：按实际返回的 title 动态渲染（外观 / 内饰 / 细节）
data.getJSONArray("catepiclist").forEach(g -> {
    JSONObject group = (JSONObject) g;
    System.out.println(group.getStr("title") + "：" + group.getJSONArray("list").size() + " 张");
});

import requests


def get_car_detail(api_key: str, data_id: str) -> dict | None:
    """按车辆 dataId 拉取车辆完整详情；查不到返回 None 且不扣费"""
    resp = requests.get(
        "https://api.xujian.tech/openapi/usedcar/detail",
        params={"dataId": data_id},
        headers={"X-API-Key": api_key},
        timeout=20,
    )
    result = resp.json()
    if result.get("code") != 0:
        print("查询失败（不收费）：", result.get("msg"))
        return None
    return result["data"]


if __name__ == "__main__":
    car = get_car_detail("你的APIKey", "60323428")
    if car:
        print(car["carname"], f'{car["mileage"]}万公里', f'{car["price"]}万元')
        for group in car.get("catepiclist", []):
            print(group["title"], len(group["list"]))

const params = new URLSearchParams({ dataId: "60323428" });

const resp = await fetch(`https://api.xujian.tech/openapi/usedcar/detail?${params}`, {
  headers: { "X-API-Key": API_KEY },
});

const { code, msg, data } = await resp.json();
if (code === 0) {
  console.log(data.carname, `${data.mileage}万公里`, `${data.price}万元`);
  // 分类图集按 title 动态渲染，不要写死「外观 / 内饰 / 细节」
  data.catepiclist.forEach((g) => console.log(g.title, g.list.length));
} else {
  console.warn("查询失败（不收费）：", msg);
}