統合ガイド

サーバーから車両を確認します。

認証

アカウントを作成し、「マイアカウント」からパスワードをコピーします。使用 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 件の応答ごとにデータベースクエリが消費されます。エラーによって残高は消費されません。 1 分あたりの制限は同じユーザーのキー間で共有され、過去 60 秒にわたってチェックされます。

現在の毎月のデータベースクエリが最初に消費され、次に追加で購入されたクエリが消費されます。リチャージは月更新時に保持されます。無料プランは使用時または cron 経由で更新されます。支払いプランは支払いが確認された後にのみ補充されます。期間が終了すると、毎月の残高は利用できなくなります。

HTTP	意味
400	フィルタまたは年の範囲が無効です。
401	API キーがありません。
402	使用できるデータベースクエリはありません。
403	アクセス権のない非アクティブなキーまたはサブスクリプション。
429	1分あたりの制限。再試行後: 60。
500 / 503	サービスまたは接続エラー。

データの範囲

末尾の年が null の場合は、末尾の年が不明であることを示し、フィルタリング時にオープン範囲として扱われます。そのモデルが現在も製造されているということを証明するものではありません。反転された範囲はレビュー保留中から除外されます。燃料、車体、その他の分野は報告されない場合があります。これらのデータはスペアパーツの互換性を保証するものではありません。この関係は販売店によって提供され、検証される必要があります。