开放接口
汽配数据开放接口
接口地址
全部接口挂在汽配插件路径下，按租户解析数据。
https://api.autopf.com/api/plugins/app/p11365281228129286必传请求头
租户头用于选择数据集，缺失会直接返回 400。
X-Tenant-Id: parts统一响应
所有响应统一包一层 code / message / data，分页结果结构一致。
{ Code, Msg, Data }接口清单
全部接口
公开接口匿名可读，数据始终只返回启用且未删除的记录。
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /PartsData/stats | 当前租户的数据覆盖计数 |
| GET | /PartsData/years | 有车型数据的年款列表 |
| GET | /PartsData/car-brands | 启用中的车品牌 |
| GET | /PartsData/car-models?carBrandId=&keyword=&pageIndex=&pageSize= | 车型列表，可按品牌与关键字过滤 |
| GET | /PartsData/parts?keyword=&categoryId=&carBrandId=&standardNameId=&brandId=&pageIndex=&pageSize= | 配件目录检索 |
| GET | /PartsData/parts/{partsId} | 单个配件详情，含适配与通用码 |
| GET | /PartsData/parts-by-car-model?carModelId=&pageIndex=&pageSize= | 按车型反查适配配件 |
| GET | /PartsData/general-codes?code=&carBrandId=&brandId=&pageIndex=&pageSize= | OE / 通用码查询，返回匹配配件 |
| GET | /PartsData/quick-search?keyword=&count= | 同一关键字同时查配件与通用码 |
| GET | /PartsData/categories?type= | 配件分类树，可按类型过滤 |
| GET | /PartsData/standard-names?keyword=&categoryId=&pageIndex=&pageSize= | 标准名称，可按分类过滤 |
| GET | /PartsData/product-brands | 启用中的配件品牌 |
| GET | /CarCascade/cascade/brands?year= | 某年款下可选的车品牌 |
| GET | /CarCascade/cascade/names?carBrandId= | 某车品牌下的车型名称 |
| GET | /CarCascade/cascade/versions?carBrandId=&carModelName= | 车门数 / 车辆类型 / 车身形式组合 |
| GET | /CarCascade/cascade/engines?carBrandId=&carModelName=&doorCount=&vehicleType=&bodyForm= | 某版本下的发动机描述 |
调用示例
任何语言都能调
纯 HTTP + JSON，不需要 SDK。
cURL
# 配件检索 curl "https://api.autopf.com/api/plugins/app/p11365281228129286/PartsData/parts?keyword=compressor&pageSize=5" \ -H "X-Tenant-Id: parts"
JavaScript
const BASE = 'https://api.autopf.com/api/plugins/app/p11365281228129286'
const headers = { 'X-Tenant-Id': 'parts' }
// 1) 配件目录检索
const parts = await fetch(`${BASE}/PartsData/parts?pageIndex=1&pageSize=12`, { headers })
.then((r) => r.json())
// 2) OE / 通用码查询，返回匹配配件
const oe = await fetch(`${BASE}/PartsData/general-codes?code=AC7805`, { headers })
.then((r) => r.json())
// 响应信封： { Code, Msg, Data }
console.log(parts.Data.Items, oe.Data.Items)统一响应
{
"Code": 200,
"Msg": "success",
"Data": {
"Items": [ { "PartsId": "…", "PartsName": "空调压缩机", "PartsNo": "234324321", "GeneralCodes": ["AC7805"] } ],
"Total": 4,
"PageIndex": 1,
"PageSize": 12
}
}接入说明
接入前请了解
分页
传 pageIndex（从 1 开始）与 pageSize，返回 Items、Total、PageIndex、PageSize。
过滤
多数列表接口支持 keyword 加业务过滤，如 categoryId、carBrandId、standardNameId。
缓存
主数据变化较慢，建议在你侧缓存数分钟到数小时，减轻对接压力。
合理使用
公开接口面向交互式查询；如需批量或定时拉取，请联系我们使用导出或托管推送。