二手车报价页可将车型 ID、里程、注册年月和城市提交给极速车服二手车估价 API；返回新车价、零售价、车商收购价及 confidence，适合初筛参考，不承诺最终成交价。

请求前先准备车型 ID

接口地址为 https://api.jisuepc.com/carvaluation/evaluate，支持 GET、POST，必填 carid、mileage、regdate、city 和 appkey。其中 carid 是车型大全接口的四级车型 ID，不是品牌名、车系名或 VIN。推荐先让用户在车型树中选择到具体年款，再把得到的 ID 传给估价接口。

https://api.jisuepc.com/carvaluation/evaluate?carid=YOUR_CAR_ID&mileage=YOUR_MILEAGE&regdate=YYYY-MM&city=YOUR_CITY&appkey=YOUR_APPKEY

官网示例使用公里数和年月格式。业务侧应限制里程为非负数，校验注册年月格式，并统一城市名称。appkey 只放服务端配置，不出现在前端代码、埋点或公开文档中。

返回值如何展示

成功结果会带回 brand、typename、carname、yeartype、fueltype、mileage、regdate、city 和 newcar_price 等车辆上下文；估价字段分为零售价和车商收购价，分别提供整体值以及 good、average、poor 档位，并有对应的元或元字符串字段。金额展示应优先使用数值字段做计算，字符串字段仅作格式化。

confidence 可能为 high、medium 或 low。前端应把它作为估值参考等级显示，并解释价格会受车况、事故维修、过户次数、配置、地区供需和实际车源影响。不要把“平均零售价”直接写成收购承诺，也不要用接口返回的示例金额制作固定广告。

错误处理

业务错误 201 表示车型 ID 为空，202 表示车型 ID 错误，203 表示未找到车型，204 表示里程无效，205 表示可比车源不足、暂无法估价。车型相关错误应回到车型选择步骤，里程错误应要求用户修正；可比车源不足时展示“暂无可靠估值”，不要用上一次查询结果顶替。系统错误 101–108 涵盖 appkey、权限、次数、IP、维护和停用状态，应分类告警并控制重试。

数据边界与发布规范

估价 API 解决的是车型与输入条件下的参考价，不负责鉴定车况、查询事故记录、核验抵押过户或出具金融评估报告。若产品面向交易，应补充检测报告、来源标识、估值时间和人工复核入口。对用户提交的里程、城市和车辆信息设置访问控制与留存期限，日志中避免保存完整查询参数。

上线前检查

  1. 用车型大全接口获取并缓存有效的四级 carid，定期处理车型下线。
  2. 分别测试无车源、低可信度和系统超限，不把错误当作 0 元。
  3. 在结果页同时显示城市、注册年月、里程、估值时间和可信度。
  4. 上线前重新核对官网接口字段、权限和计费规则，本文未进行真实请求验证。

参考

关于极速车服

极速车服（JisuEPC）提供汽车后市场数据与接口服务。本文聚焦二手车估价 API 的四级车型 ID、里程、注册年月、城市、价格分档与 confidence 展示；返回值是参考估值，不构成车况鉴定、金融评估或成交承诺，具体字段以官方文档为准。

标签：