PANDUAN INTEGRASI

Periksa kendaraan dari server Anda.

Otentikasi

Buat akun dan salin kata sandi Anda dari Akun Saya. Menggunakan Authorization: Bearer TU_CLAVE atau tajuk X-API-Key. Jangan menaruh kunci di URL, HTML publik, atau JavaScript browser.

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

Filter dan penomoran halaman

Parameter	Gunakan
brand / brand_id	Merek atau pengenal yang tepat.
model / model_id	Bagian dari nama atau pengenal.
cc, kw, cv	Nilai numerik yang tepat.
y1, y2	Tumpang tindih dengan selang waktu tahun. Untuk tahun tertentu, gunakan keduanya dengan nilai yang sama.
limit	Antara 1 dan 100; bawaan 50.
offset	Dari 0. Gunakan next_offset ketika has_more bernilai true.

{
  "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
}

Contoh ilustrasi format. Hasil spesifiknya bergantung pada katalog.

Filter katalog terbaru

generation, fuel, technology, engine: Nilai teks yang sama persis.

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

Keseimbangan dan batasan

Setiap 200 respons menggunakan kueri database, meskipun tidak ada kecocokan. Kesalahan tidak menghabiskan saldo. Batas per menit dibagi antara tombol pengguna yang sama dan diperiksa selama 60 detik terakhir.

Permintaan basis data bulanan saat ini dihabiskan terlebih dahulu dan kemudian permintaan tambahan yang dibeli. Pengisian ulang disimpan saat memperbarui bulan. Paket gratis diperbarui saat digunakan atau melalui cron; Paket pembayaran hanya diisi ulang setelah pembayaran terverifikasi. Jika periodenya habis, saldo bulanan Anda tidak lagi tersedia.

HTTP	Artinya
400	Filter atau rentang tahun tidak valid.
401	Kunci API tidak ada.
402	Tidak ada kueri basis data yang tersedia.
403	Kunci tidak aktif atau langganan tanpa akses.
429	Batas per menit; Coba Lagi-Setelah: 60.
500 / 503	Kesalahan layanan atau koneksi.

Ruang Lingkup Data

Tahun tambahan yang nol menunjukkan bahwa tahun terakhir tidak diketahui, dan diperlakukan sebagai rentang terbuka saat memfilter. Itu tidak membuktikan bahwa model tersebut masih diproduksi. Rentang terbalik dikecualikan sambil menunggu peninjauan. Bahan bakar, badan, dan bidang lainnya tidak boleh dilaporkan. Data ini tidak menjamin kompatibilitas suku cadang: hubungan ini harus disediakan dan divalidasi oleh toko.