Specifiche REST API
Tutti i percorsi sono serviti tramite il proxy canonico del dominio con compressione Brotli/Gzip e supportano output in formato application/json. Gli endpoint pubblici non richiedono chiavi di autenticazione.
Catalogo Civico & Luoghi
Consultazione dei punti di interesse, monumenti storici, sentieri, spiagge e attività
/api/v1/public/salernos/placesAttivoRecupera la lista dei luoghi georeferenziati con filtri per categoria, testo di ricerca, comune e limite numerico.
/api/v1/public/salernos/open-data/categoriesAttivoRestituisce l'elenco delle categorie ufficiali con conteggio dei record disponibili per ciascuna.
/api/v1/public/salernos/open-data/citiesAttivoElenco dei comuni della provincia coperti dal dataset SalernOS.
/api/v1/public/salernos/open-data/sourcesAttivoVerifica di provenienza con licenza per ciascun fornitore dati (CC-BY 4.0, ODbL).
Eventi & Manifestazioni
Calendario culturale, rassegne comunali e celebrazioni patronali
/api/v1/public/salernos/eventsAttivoRecupera gli eventi programmati con orari, luoghi, categorie e link a biglietterie ufficiali esterne.
AI Concierge & Chat Gateway
Gateway di conversazione civica territoriale basato su matching deterministico e modello LLM isolato
/api/v1/public/brands/salernos/chatAttivoInvia una query in linguaggio naturale all'assistente territoriale e riceve testo, schede luoghi e azioni consigliate.
Statistiche & Circuito Partner
Metriche di adesione, candidatura esercenti e verifica voucher
/api/salernos/hero-statsAttivoRestituisce i conteggi reali delle attività aderenti e dei fondatori senza stime o mock.
/api/salernos/partnersAttivoRegistra la candidatura di un'attività nel Circuito SalernOS e crea le credenziali d'accesso.
/api/salernos/partners/verify-ticketAttivoConsente a un esercente accreditato di validare e riscattare un codice voucher mostrato da un cliente.