ENTEGRASYON KILAVUZU

Sunucunuzdan araçları kontrol edin.

Kimlik doğrulama

Bir hesap oluşturun ve şifrenizi Hesabım'dan kopyalayın. Kullanmak Authorization: Bearer TU_CLAVE veya başlık X-API-Key. Anahtarları URL'lere, genel HTML'ye veya tarayıcı JavaScript'ine koymayın.

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

Filtreler ve sayfalandırma

Parametre	Kullanım
brand / brand_id	Tam marka veya tanımlayıcı.
model / model_id	Adın veya tanımlayıcının bir kısmı.
cc, kw, cv	Tam sayısal değerler.
y1, y2	Yıl aralığıyla örtüşme. Belirli bir yıl için her ikisini de aynı değerde kullanın.
limit	1 ile 100 arasında; varsayılan 50.
offset	0'dan itibaren. has_more doğru iken next_offset'i kullanın.

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

Açıklayıcı format örneği. Spesifik sonuçlar kataloğa bağlıdır.

Güncellenmiş katalog filtreleri

generation, fuel, technology, engine: Tam eşleşen metin değerleri.

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

Denge ve sınırlar

Her 200 yanıt, eşleşme olmasa bile bir veritabanı sorgusu tüketir. Hatalar dengeyi tüketmez. Dakika başına limit aynı kullanıcının tuşları arasında paylaştırılır ve son 60 saniye boyunca kontrol edilir.

Önce mevcut aylık veritabanı sorguları, ardından satın alınan ek sorgular harcanır. Ay yenilenirken yüklemeler korunur. Ücretsiz planlar kullanım sonrasında veya cron aracılığıyla yenilenir; Ödeme planları yalnızca doğrulanmış bir ödeme sonrasında yenilenir. Süre dolduğunda aylık bakiyeniz artık kullanılamaz.

HTTP	Anlamı
400	Geçersiz filtreler veya yıl aralığı.
401	API anahtarı eksik.
402	Kullanılabilir veritabanı sorgusu yok.
403	Etkin olmayan anahtar veya erişimi olmayan abonelik.
429	Dakika başına limit; Tekrar Dene-Sonra: 60.
500 / 503	Servis veya bağlantı hatası.

Veri Kapsamı

Boş bir takip eden yıl, takip eden yılın bilinmediğini ve filtreleme sırasında açık bir aralık olarak değerlendirildiğini gösterir. Modelin halen üretildiğini kanıtlamaz. Ters çevrilmiş aralıklar, incelenmek üzere hariç tutulur. Yakıt, gövde ve diğer alanlar bildirilmeyebilir. Bu veriler bir yedek parçanın uyumluluğunu garanti etmez: bu ilişki mağaza tarafından sağlanmalı ve doğrulanmalıdır.