二手车残值评估 API20 项参数算出收车报价参考区间收车、置换、拍卖、金融放款都要回答同一个问题这辆车现在值多少钱。靠评估师拍脑袋不同人给出不同区间靠自己建模型缺的是覆盖全国、按车况分层的成交样本。usedcar.price把这件事做成一个 POST 接口最多 20 个车辆参数进去返回合理价格区间万元并且评估不出价格时不收费。接口速览关键事实说明接口地址https://api.xujian.tech/openapi/usedcar/price接口编码usedcar.price请求方式POST参数放 JSON body鉴权方式请求头X-API-Key不做签名、时间戳或加密必填约束brand与model至少填一个单个字符串字段不超过 50 字符返回核心字段priceStart下限万元/priceEnd上限万元/tip口径说明计费方式按次计费0.5 元/次先预鉴权、评估出区间后再扣费不计费场景请求体为空或品牌型号皆空、字段超长、服务不可用、模型评估不出价格建议超时30 秒以上含模型推理单次耗时通常 1 ~ 数秒costMs为真实耗时示例 2350一、哪些业务需要这一步场景具体用法门店收车报价评估师报价前先看参考区间支撑谈判与复核置换补差价旧车残值 × 新车优惠算出用户实际要补多少挂牌定价校验把挂牌价与评估区间对比判断是否偏离市场金融分期额度以评估价作为车辆价值参考核定放款上限拍卖起拍价批量车源按区间设定起拍价与保留价车队资产重估营运车队年度盘点批量重估资产净值保险与定损参考全损、盗抢险理赔时提供市场价值参考事故折价测算同一辆车按 0 ~ 3 级事故跑多次量化折旧幅度车商风控收车价与评估价偏离过大时触发人工复核内容型产品车型详情页展示「市场参考价区间」提升转化二、请求参数2.1 请求头参数名必填说明X-API-Key是开发者 API Key缺失或无效直接返回失败Content-Type是固定application/json2.2 业务参数POST JSON body全部可选参数名类型示例说明brandString大众品牌与model至少填一个modelString迈腾型号与brand至少填一个yearString2023年款configurationString330TSI DSG 豪华型配置版本registrationDateString2022-03上牌时间格式YYYY-MMmileageString8.5行驶里程万公里权重最高的字段accidentHistoryString0事故等级0无事故 /1轻微剐蹭 /2更换覆盖件 /3结构损伤transferCountString1过户次数maintenanceRecordString全程4S店保养保养记录fuelTypeString汽油燃油类型汽油 / 柴油 / 纯电 / 混动transmissionTypeString自动变速箱自动 / 手动displacementString2.0排量LcolorString黑色车身颜色locationString北京车辆所在地影响地域差价descriptionString车辆外观完好内饰9成新无任何改装车辆描述自然语言模型参与解析vinStringLFV3A23C5N3123456车架号 VINengineModelStringEA888发动机型号emissionStandardString国六排放标准underWarrantyString是是否在质保期vehicleUsageString家用车辆用途家用 / 营运 / 租赁接口会对所有字符串字段做去空格 长度校验任一字段超过50 个字符直接返回失败不计费。2.3 填哪些字段最有用影响权重较大的字段依次是行驶里程 → 车龄上牌时间 / 年款→ 车辆所在地 → 事故历史等级。只填品牌型号也能出结果但区间会明显变宽例如 7.2 ~ 12.4 万补全上牌时间 里程后区间通常收窄一半以上location对地域差价敏感的车系影响明显务必填。三、返回字段3.1 顶层与 data字段类型说明codeint0成功非 0 失败统一为500msgString成功为success失败为具体原因dataObject业务数据失败时为nulldata 字段字段类型示例说明priceStartDouble8.6评估价格下限万元priceEndDouble10.2评估价格上限万元tipString估计信息来源网络内容仅供参考结果口径说明apiCodeStringusedcar.price接口编码apiNameString二手车价格评估接口名称chargeTypeStringPER_CALL计费类型balanceBigDecimal99.9500扣费后的账户余额元costMsLong2350本次调用耗时毫秒tip是结果的口径说明展示给用户时建议一并带上——它是区间值而不是成交价。四、调用示例4.1 curlcurl-s-XPOSThttps://api.xujian.tech/openapi/usedcar/price\-HX-API-Key: 你的APIKey\-HContent-Type: application/json\-d{ brand: 大众, model: 迈腾, year: 2023, registrationDate: 2022-03, mileage: 8.5, location: 北京, accidentHistory: 0, transferCount: 1, fuelType: 汽油, transmissionType: 自动 }4.2 JavaHutoolimportcn.hutool.http.HttpRequest;importcn.hutool.json.JSONObject;importcn.hutool.json.JSONUtil;publicclassUsedCarPriceClient{privatestaticfinalStringAPI_URLhttps://api.xujian.tech/openapi/usedcar/price;/** * 评估二手车价格区间 * * param apiKey 开发者 API Key * param params 车辆参数brand 与 model 至少填一个 * return data 节点评估不出价格返回 null且不扣费 */publicstaticJSONObjectevaluate(StringapiKey,JSONObjectparams){JSONObjectjsonJSONUtil.parseObj(HttpRequest.post(API_URL).header(X-API-Key,apiKey).body(params.toString()).timeout(30000).execute().body());if(json.getInt(code)null||json.getInt(code)!0){System.out.println(评估失败不收费json.getStr(msg));returnnull;}returnjson.getJSONObject(data);}publicstaticvoidmain(String[]args){JSONObjectparamsJSONUtil.createObj().set(brand,大众).set(model,迈腾).set(registrationDate,2022-03).set(mileage,8.5).set(location,北京);JSONObjectdataevaluate(你的APIKey,params);if(data!null){System.out.printf(参考区间%.2f ~ %.2f 万元%n,data.getDouble(priceStart),data.getDouble(priceEnd));}}}4.3 Pythonimportrequestsdefusedcar_price(api_key:str,**params):返回 data 节点评估不出价格返回 None且不扣费resprequests.post(https://api.xujian.tech/openapi/usedcar/price,jsonparams,headers{X-API-Key:api_key},timeout30,)resultresp.json()ifresult.get(code)!0:print(评估失败不收费,result.get(msg))returnNonereturnresult[data]if__name____main__:datausedcar_price(你的APIKey,brand大众,model迈腾,registrationDate2022-03,mileage8.5,location北京)ifdata:print(data[priceStart],data[priceEnd],data[tip])4.4 JavaScriptasyncfunctionusedCarPrice(apiKey,params){constrespawaitfetch(https://api.xujian.tech/openapi/usedcar/price,{method:POST,headers:{X-API-Key:apiKey,Content-Type:application/json},body:JSON.stringify(params)});constresultawaitresp.json();if(result.code!0){thrownewError(result.msg);}returnresult.data;}五、返回示例参数较完整时的区间{code:0,msg:success,data:{priceStart:8.6,priceEnd:10.2,tip:估计信息来源网络内容仅供参考,apiCode:usedcar.price,apiName:二手车价格评估,chargeType:PER_CALL,balance:99.9500,costMs:2350}}只给型号时的保守区间明显更宽{code:0,msg:success,data:{priceStart:7.2,priceEnd:12.4,tip:估计信息来源网络内容仅供参考,apiCode:usedcar.price,apiName:二手车价格评估,chargeType:PER_CALL,balance:99.9000,costMs:2680}}评估不出价格不收费{code:500,msg:未能评估出该车的价格区间请补充品牌、型号、上牌时间与行驶里程后重试本次调用不计费,data:null}六、可直接复用的两段代码6.1 收车报价在区间内取一个可谈判价defsuggest_buy_price(data:dict,discount:float0.95):收车价取区间下限再打折留谈判空间returnround(data[priceStart]*discount,2)defsuggest_sale_price(data:dict,premium:float1.05):挂牌价取区间上限再上浮留议价空间returnround(data[priceEnd]*premium,2)6.2 量化事故与过户的折价幅度defaccident_effect(api_key:str,base:dict):同一辆车按 0 ~ 3 级事故各跑一次返回折价曲线curve{}forlevelin[0,1,2,3]:paramsdict(base,accidentHistorylevel)datausedcar_price(api_key,**params)ifdata:curve[level](data[priceStart],data[priceEnd])returncurve批量评估建议低并发评估类接口单次耗时高于查询类秒级并发容易把对方和自己都拖慢。七、实践建议至少补全四个字段品牌 / 型号 上牌时间 里程 所在地区间会明显收窄。超时设 30 秒以上。含模型推理costMs常在 2 秒以上别用查询类接口的 5 秒超时。0.5 元/次别做高频轮询。同一辆车短时间内重复评估没有意义结果缓存 7 ~ 30 天。区间不是报价。它给的是合理价格带收车 / 挂牌要在这个带里结合车况与库存策略取值。tip要展示给用户。这是口径说明也是免责依据别只在内部日志里留着。评估不出不收费可以补充字段重试但如果两次都评估不出说明车型太冷门或信息太少应转人工。字段别超 50 字符。description很容易写长超长直接失败且不计费前端要做长度限制。批量任务做幂等。同一辆车的评估请求按 VIN 或「品牌 型号 上牌 里程」去重避免重复计费。八、错误码与排查codemsg是否扣费0success扣费评估出区间后结算500缺少请求头 X-API-Key否500API Key 无效 / API Key 已停用否500客户不存在或已停用否500接口不存在或已停用否500余额不足请先充值否500请求体不能为空brand 与 model 至少填一个否500brand 与 model 至少填一个填写越完整估值越准确否500xxx 长度不能超过 50 个字符否500未能评估出该车的价格区间请补充品牌、型号、上牌时间与行驶里程后重试本次调用不计费否500二手车服务未启用 / 二手车服务未配置上游凭证缺失否500数据服务暂时不可用请求上游超时或网络异常否九、计费与接入项目说明单价0.5 元/次计费方式按次计费调用前校验余额先预鉴权评估出价格区间后才扣费不计费场景请求体为空或品牌型号皆空、字段超长、服务不可用、模型评估不出价格建议超时30 秒以上含模型推理接入流程注册开发者账号 → 控制台创建 API Key → 请求头带上X-API-Key即可调用无需签名或加密。控制台可查看调用量、扣费流水与余额。服务站点api.xujian.tech纯文本域名不做跳转。接口试用、数据与充值咨询可在控制台提交工单或联系 Vxujian_cq。十、小结二手车估价的本质是「用足够多的可比样本推出一个区间」自己做要养数据、养模型做成接口之后成本变成每次五毛、并且评估不出不收费。使用时要记住填得越全区间越窄里程、上牌时间、所在地、事故等级是四个关键字段区间不是成交价收车取下限打折、挂牌取上限上浮是更实际的用法0.5 元/次 含模型推理超时要放宽、并发要放低、结果要缓存评估不出不收费可以放心补充字段重试但连续失败应转人工。配套接口usedcar.list0.01 元/次用于批量拉在售车源先拉车源再逐辆评估即可完成「选品 → 定价」的完整链路。