{"openapi":"3.1.0","info":{"title":"QuiConcessionario Catalog API","version":"1.0.0","description":"Catalogo tecnico auto: marche, modelli, allestimenti con scheda completa, prezzo nuovo stimato e valutazione usato per anno. Banca dati proprietaria (Dir. UE 96\/9\/CE)."},"servers":[{"url":"https:\/\/quiconcessionario.it\/api\/v1"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"paths":{"\/stats":{"get":{"summary":"Statistiche del catalogo","responses":{"200":{"description":"OK"}}}},"\/brands":{"get":{"summary":"Elenco marche","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"per_page","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"\/brands\/{brand}":{"get":{"summary":"Marca con modelli","parameters":[{"name":"brand","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Non trovata"}}}},"\/models\/{brand}\/{model}":{"get":{"summary":"Modello con allestimenti e scheda completa","parameters":[{"name":"brand","in":"path","required":true,"schema":{"type":"string"}},{"name":"model","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Non trovato"}}}},"\/trims\/{id}":{"get":{"summary":"Allestimento singolo (scheda + valutazione usato)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"}}}},"\/compare":{"get":{"summary":"Confronto allestimenti (max 6)","parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"id separati da virgola"}],"responses":{"200":{"description":"OK"}}}},"\/valuation":{"get":{"summary":"Valutazione usato parametrica","parameters":[{"name":"trim_id","in":"query","required":true,"schema":{"type":"integer"}},{"name":"year","in":"query","schema":{"type":"integer"},"description":"Anno di immatricolazione"},{"name":"km","in":"query","schema":{"type":"integer"}},{"name":"condition","in":"query","schema":{"type":"string","enum":["excellent","good","fair","poor"]}}],"responses":{"200":{"description":"Stima indicativa con range"},"422":{"description":"Parametri non validi"}}}},"\/changes":{"get":{"summary":"Allestimenti modificati dopo un timestamp (sync)","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"OK"}}}},"\/me":{"get":{"summary":"Info chiave\/piano e consumo del chiamante","security":[{"ApiKeyAuth":[]}],"responses":{"200":{"description":"OK"}}}},"\/search":{"get":{"summary":"Ricerca modelli","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"brand","in":"query","schema":{"type":"string"}},{"name":"segment","in":"query","schema":{"type":"string"}},{"name":"body","in":"query","schema":{"type":"string","enum":["city_car","berlina","station_wagon","suv","coupe","cabrio","monovolume","pickup"]}},{"name":"fuel","in":"query","schema":{"type":"string"}},{"name":"year","in":"query","schema":{"type":"integer"}},{"name":"power_min","in":"query","schema":{"type":"integer"}},{"name":"power_max","in":"query","schema":{"type":"integer"}},{"name":"in_production","in":"query","schema":{"type":"boolean"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["name","-name","year_from","-year_from","year_to","-year_to"]}},{"name":"facets","in":"query","schema":{"type":"string"},"description":"Campi per i conteggi aggregati: brand,segment,body,year"}],"responses":{"200":{"description":"OK"}}}}}}