GUIDA ALL'INTEGRAZIONE

Controlla i veicoli dal tuo server.

Autenticazione

Crea un account e copia la tua password da Il mio account. Utilizzo Authorization: Bearer TU_CLAVE o l'intestazione X-API-Key. Non inserire chiavi negli URL, nel codice HTML pubblico o nel JavaScript del browser.

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

Filtri e impaginazione

Parametro	Utilizzare
brand / brand_id	Marchio o identificatore esatto.
model / model_id	Parte del nome o dell'identificatore.
cc, kw, cv	Valori numerici esatti.
y1, y2	Si sovrappongono con l'intervallo di anni. Per un anno specifico, utilizzali entrambi con lo stesso valore.
limit	Tra 1 e 100; predefinito 50.
offset	Da 0. Usa next_offset mentre has_more è vero.

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

Esempio illustrativo di formato. I risultati specifici dipendono dal catalogo.

Filtri del catalogo aggiornato

generation, fuel, technology, engine: Valori di testo esatti.

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

Equilibrio e limiti

Ogni 200 risposte consuma una query del database, anche se non ci sono corrispondenze. Gli errori non consumano l’equilibrio. Il limite al minuto è condiviso tra le chiavi dello stesso utente e viene controllato negli ultimi 60 secondi.

Vengono spese prima le query mensili correnti del database e poi quelle aggiuntive acquistate. Le ricariche vengono conservate al rinnovo del mese. I piani gratuiti si rinnovano all'utilizzo o tramite cron; I piani di pagamento vengono ripristinati solo dopo un pagamento verificato. Se il periodo scade, il tuo saldo mensile non sarà più disponibile.

HTTP	Significato
400	Filtri o intervallo di anni non validi.
401	Chiave API mancante.
402	Nessuna query di database disponibile.
403	Chiave inattiva o abbonamento senza accesso.
429	Limite al minuto; Riprova dopo: 60.
500 / 503	Errore di servizio o di connessione.

Ambito dei dati

Un anno finale nullo indica che l'anno finale non è noto e viene trattato come un intervallo aperto durante il filtraggio. Ciò non prova che il modello sia ancora in produzione. Gli intervalli invertiti sono esclusi in attesa di revisione. Carburante, carrozzeria e altri campi potrebbero non essere riportati. Questi dati non garantiscono la compatibilità del pezzo di ricambio: questo rapporto deve essere fornito e validato dal negozio.