集成指南

从您的服务器检查车辆。

认证

创建一个帐户并从“我的帐户”复制您的密码。使用 Authorization: Bearer TU_CLAVE 或标题 X-API-Key。不要将密钥放入 URL、公共 HTML 或浏览器 JavaScript 中。

curl "https://TU_DOMINIO/api/search.php?brand=Abarth&model=124&y1=2018&y2=2018&limit=10" \
  -H "Authorization: Bearer TU_CLAVE"

过滤器和分页

参数	使用
brand / brand_id	确切的品牌或标识符。
model / model_id	名称或标识符的一部分。
cc, kw, cv	精确的数值。
y1, y2	与年份间隔重叠。对于特定年份，请使用具有相同值的两者。
limit	1 到 100 之间；默认 50。
offset	从 0 开始。当 has_more 为 true 时，使用 next_offset。

{
  "results": [
    {"id": 1, "brand": "Abarth", "model": "124 Spider",
     "cc": 1368, "kw": 125, "cv": 170, "engine_code": "552 53 268",
     "year_start": 2018, "year_end": 2019, "fuel": null, "body": null}
  ],
  "count": 1, "limit": 10, "offset": 0,
  "has_more": false, "next_offset": null, "tokens_remaining": 99
}

格式的说明性示例。具体结果以目录为准。

更新后的目录筛选条件

generation, fuel, technology, engine: 精确匹配文本值。

fuel=Diésel&technology=TDI&engine=BKD

平衡与限制

每个 200 响应都会消耗一次数据库查询，即使没有匹配项也是如此。错误不会消耗余额。每分钟的限制在同一用户的密钥之间共享，并在过去 60 秒内进行检查。

首先花费当前每月的数据库查询，然后再花费额外购买的查询。续订当月时，充值金额会保留。免费计划在使用时或通过 cron 更新；仅在验证付款后才会补充付款计划。如果期限到期，您的每月余额将不再可用。

HTTP	含义
400	过滤器或年份范围无效。
401	API 密钥丢失。
402	没有可用的数据库查询。
403	无效密钥或订阅无法访问。
429	每分钟限制；重试后：60。
500 / 503	服务或连接错误。

数据范围

空尾随年份表示尾随年份未知，并且在过滤时被视为开放范围。这并不能证明该模型仍在制造。倒排范围被排除在外，等待审核。 Fuel、body等字段可以不报告。这些数据不保证备件的兼容性：这种关系必须由商店提供和验证。