L'API è di tipo REST e permette l'accesso libero, con limitazione di tipo throttle, e in sola lettura.

L'API REST è sviluppata secondo lo standard Open API. La documentazione interattiva, generata e aggiornata automaticamente, permette di esplorare lo schema dei dati ed effettuare richieste alle API.

L'API fornisce risposte in formato JSON o in formato HTML navigabile ed è quindi esplorabile da browser, con filtri, ricerche e ordinamento dei risultati.

Le risposte sono paginate, con 50 risultati per pagina di default, estendibili fino a 1000. I link per caricare le pagine successive o precedenti si trovano sotto forma di URL nella stessa pagina dei risultati.

Le richieste sono attualmente limitate a 10000 al giorno per utenti anonimi, mentre sono illimitate per utenti autorizzati.

L'autorizzazione può essere fatta attraverso un token o con la basic HTTP Basic Auth. Per avere un token di accesso o una username e password, con le istruzioni per l'autenticazione, scriveteci. info[at]openpolis.it.

Tutti gli endpoint rispondono esclusivamente su porta HTTPS, in modo che l'invio dei parametri di autorizzazione avvenga su un canale protetto.

Licenze di utilizzo dei dati

I dati esposti sono rilasciati con licenza ODbL 1.0.

Contatti

Per informazioni sull'utilizzo dei dati, eventuali segnalazioni di errori e tecnologie: info[at]openpolis[dot]it.

GET /api/v1/?format=api