[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 用于查看调用方式和响应结构，返回范围以示例参数为准。

请求参数

参数	类型	必填	默认值	说明
brand_id	string	否	无	见接口说明
pageIndex	integer	否	1	见接口说明
pageSize	integer	否	50	见接口说明

正常响应

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

本页响应是通过本请求取得的真实固定 Demo；计数仅表示该样例，不代表全库规模。

返回响应

🟢200成功

application/json

业务码 100,501

Bodyapplication/json

示例

固定样例的车系或车型查询结果，数量仅代表当前样例。

{"DataStatus":{"StatusCode":100,"RequestParameter":"pageIndex=1\u0026pageSize=50","StatusDescription":"Request successful.","ResponseDateTime":"2026-10-26 14:18:31.941","DataTotalCount":5},"Data":{"Items":[{"SeriesId":"24ac6c254bbcbd14bc7f9fbfb35dc97a","BrandId":"50c1b22205770a1ecc9e111416cc7d3e","BrandName":"特斯拉","SubBrandId":"c0da58f854ec0dabdb5e99a1d31aa306","SubBrandName":"特斯拉(进口)","SeriesName":"Model S","CarType":null,"SaleStatus":"在售"},{"SeriesId":"9bbee8dde6906f8249cb0b94675101e1","BrandId":"50c1b22205770a1ecc9e111416cc7d3e","BrandName":"特斯拉","SubBrandId":"c0da58f854ec0dabdb5e99a1d31aa306","SubBrandName":"特斯拉(进口)","SeriesName":"Model X","CarType":"中大型SUV","SaleStatus":"在售"},{"SeriesId":"7878beaf6ebad22fca1f217f21127b77","BrandId":"50c1b22205770a1ecc9e111416cc7d3e","BrandName":"特斯拉","SubBrandId":"9fa1278295e38a3e13a8f1e47c98be4d","SubBrandName":"特斯拉中国","SeriesName":"Model 3","CarType":"中型车","SaleStatus":"在售"},{"SeriesId":"caffd0011d1aeb49feb1d2543fba3bad","BrandId":"50c1b22205770a1ecc9e111416cc7d3e","BrandName":"特斯拉","SubBrandId":"9fa1278295e38a3e13a8f1e47c98be4d","SubBrandName":"特斯拉中国","SeriesName":"Model Y","CarType":"中型SUV","SaleStatus":"在售"},{"SeriesId":"5f13853e250ccf150ec19cfa4fa567df","BrandId":"50c1b22205770a1ecc9e111416cc7d3e","BrandName":"特斯拉","SubBrandId":"9fa1278295e38a3e13a8f1e47c98be4d","SubBrandName":"特斯拉中国","SeriesName":"Model Y L","CarType":"中大型SUV","SaleStatus":"在售"}],"PageIndex":1,"PageSize":50,"TotalSize":5}}

🔴500500

当前接口契约#

请求参数#

正常响应#

业务状态说明#

请求参数

请求示例代码

返回响应

当前接口契约

请求参数

正常响应

业务状态说明