[DEMO] 车型库聚合预览

按品牌、车系和车型组织汽车目录，支持关联查询。
支持关键词、年款、销售状态、车型级别及价格区间筛选。
返回稳定的公开 ID，便于关联品牌、子品牌、车系和车型。
未知车型级别、年款或销售状态返回 null。
无匹配列表返回空 Items；数据服务不可用时明确返回错误。
提供固定样例快照，聚合统计仅代表样例内容，不代表全库。
GET 参数不可重复；Query、现有 Header、Bearer 凭据必须一致。参数错误保持 HTTP 200 / 501。分页默认 1/50，非正值归一化，pageSize 最大 100。价格为有限非负数，单位万元；年款范围 1800–2200。
公开样例为 2026-09-30 固定快照；数量仅代表样例。

当前接口契约

接口详情：https://www.gugudata.com/api/details/vehicle-catalog

公开 Demo 用于查看调用方式和响应结构，返回范围以示例参数为准。

请求参数

参数	类型	必填	默认值	说明
pageIndex	integer	否	1	默认 1，非正值归一化为 1。
pageSize	integer	否	50	默认 50，非正值归一化为 50，最大 100。

正常响应

HTTP 200，application/json。

字段	类型	说明
DataStatus	object
DataStatus.RequestParameter	string
DataStatus.StatusCode	integer
DataStatus.StatusDescription	string
DataStatus.ResponseDateTime	string
DataStatus.DataTotalCount	integer
Data	见响应定义

业务状态说明

业务状态码	业务状态码解释	备注
100	成功	HTTP 200
501	参数错误或车系不存在	HTTP 200
900	数据服务暂不可用	HTTP 500

常见问题

如何从品牌查到车系和具体车型？

先在品牌列表读取 BrandId，再用 brand_id 查询车系列表。拿到 SeriesId 后，可查询车系详情，或把它作为 series_id 传给车型列表以查看具体年款。

如何筛选年款和预算？

车型列表支持 year 或 year_min、year_max，并支持官方价格区间。车系列表还支持经销商价格区间。价格单位为万元，填写上下限时应保证下限不大于上限。

如何处理分页和未知信息？

品牌、车系和车型列表通过 PageIndex、PageSize 和 TotalSize 分页，单页最多 100 条。销售状态、车型级别或年款为 null 时，可以按资料暂缺展示。

聚合预览与正式接口的返回结构一样吗？

聚合预览无需 AppKey，汇集品牌、车系和车型的样例，方便查看查询流程。正式列表在 Data.Items 中返回条目，正式车系详情在 Data 中返回对象。

返回响应

🟢200成功

application/json

业务码 100,501

Bodyapplication/json

示例

{
    "DataStatus": {
        "ResponseDateTime": "string",
        "DataTotalCount": 0,
        "RequestParameter": "string",
        "StatusDescription": "string",
        "StatusCode": 100
    },
    "Data": {
        "Summary": {},
        "FeaturedBrands": [],
        "LookupExamples": [],
        "RelatedApiExamples": {}
    }
}

🔴500业务码 900

当前接口契约#

请求参数#

正常响应#

业务状态说明#

常见问题#

如何从品牌查到车系和具体车型？#

如何筛选年款和预算？#

如何处理分页和未知信息？#

聚合预览与正式接口的返回结构一样吗？#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应

业务状态说明

常见问题

如何从品牌查到车系和具体车型？

如何筛选年款和预算？

如何处理分页和未知信息？

聚合预览与正式接口的返回结构一样吗？