Aggiunto supporto a XML e CSV, aggiornata documentazione

Author: Samurai016

README.md

@@ -1,25 +1,39 @@
 # [Comuni ITA API](https://samurai016.github.io/Comuni-ITA/)
-![Versione](https://img.shields.io/badge/versione-v3.0.2-%23007ec6?style=flat-square)
+![Versione](https://img.shields.io/badge/versione-v3.1.0-%23007ec6?style=flat-square)
 [![Hosted on Supabase](https://img.shields.io/badge/Hosted%20on%20Supabase-passing?style=flat-square&logo=supabase&labelColor=1c1c1c&color=1c1c1c)](https://axqvoqvbfjpaamphztgd.functions.supabase.co)
 [![Leggi la documentazione](https://img.shields.io/badge/Leggi%20la%20documentazione%20Swagger-passing?style=flat-square&logo=Read%20the%20Docs&labelColor=8CA1AF&color=8CA1AF&logoColor=white)](https://samurai016.github.io/Comuni-ITA/)
 
 > ### Legacy project
 > Questa repository è la versione aggiornata della repository [Comuni-ITA-legacy](https://github.com/Samurai016/Comuni-ITA-legacy).  
 > È possibile usare quella repository per installare una versione standalone dell'API non gestita con Supabase.
 
-Tramite questa REST API hai accesso ad una lista di tutti i comuni, le province e le regioni italiane. I dati sono ottenuti e aggiornamenti da un sistema di aggiornamento semiautomatico che preleva i dati direttamente dagli archivi ISTAT e integra le informazioni mancanti interrogando Wikidata.
-I dati non ottenuti automaticamente dal sistema vengono inoltrati direttamente a me che procedo a verificarli e modificarli manualmente.
+Tramite questa REST API hai accesso ad una lista di tutti i comuni, le province e le regioni italiane. I dati sono ottenuti e aggiornamenti da un sistema di aggiornamento semiautomatico che preleva i dati direttamente dagli archivi ISTAT e integra le informazioni mancanti interrogando Wikidata.  
+I dati non ottenuti automaticamente dal sistema vengono inoltrati direttamente a me che procedo a verificarli e modificarli manualmente.  
 
-L'API è scaricabile e installabile su una propria istanza di Supabase oppure è usufruibile in maniera gratuita all'indirizzo https://axqvoqvbfjpaamphztgd.functions.supabase.co.
-Dato che l'API è hostata su un servizio gratuito sarebbe opportuno evitare di sovraccaricare l'API per dare a tutti la possibilità di accedervi.
+L'API è scaricabile e installabile su una propria istanza di Supabase oppure è usufruibile in maniera gratuita all'indirizzo https://axqvoqvbfjpaamphztgd.functions.supabase.co.  
+Dato che l'API è hostata su un servizio gratuito sarebbe opportuno evitare di sovraccaricare l'API per dare a tutti la possibilità di accedervi.  
 
-In questa wiki troverai una spiegazione di come funzionano gli endpoint e di come installare l'API su un server.
+In questa wiki troverai una spiegazione di come funzionano gli endpoint e di come installare l'API su un server.  
 
-La documentazione è disponibile anche all'indirizzo https://samurai016.github.io/Comuni-ITA/ sotto forma di documentazione Swagger.
+La documentazione è disponibile anche all'indirizzo https://samurai016.github.io/Comuni-ITA/ sotto forma di documentazione Swagger.  
 
 **License:** [MIT](https://opensource.org/licenses/MIT)  
 **Credits:** Logo inpired by: [Castle by Jasfart from the Noun Project](https://thenounproject.com/omataloon/)
 
+# Indice
+
+- [Endpoints](#endpoints)
+  - [GET /comuni](#-comuni)
+  - [GET /comuni/{regione}](#-comuniregione)
+  - [GET /comuni/provincia/{provincia}](#-comuniprovinciaprovincia)
+  - [GET /province](#-province)
+  - [GET /province/{regione}](#-provinceregione)
+  - [GET /regioni](#-regioni)
+- [Dettagli sulle regioni e sulle province](#dettagli-sulle-regioni-e-sulle-province)
+- [Sistema di paging](#sistema-di-paging)
+- [Installazione su server proprio](#installazione-su-server-proprio)
+  - [Sistema di aggiornamento](#sistema-di-aggiornamento)
+
 # Endpoints
 
 ## [![GET](https://img.shields.io/static/v1?label=%20&message=GET&color=187bdf&style=flat-square) /comuni](https://axqvoqvbfjpaamphztgd.functions.supabase.co/comuni)
@@ -63,6 +77,16 @@ Ottieni la lista delle regioni italiane.
 Per evitare incongruenze coi nomi di regioni e province, si consiglia di verificare i nomi attraverso gli endpoint `/regioni` e `/province`.  \
 In generale i nomi vanno scritti utilizzando i caratteri speciali come apostrofi, spazi o trattini.
 
+# Sistema di paging
+
+A causa delle risorse limitate di Supabase, è stato implementato un sistema di paging per evitare di sovraccaricare il server.   
+**Il sistema limita la risposa a 500 elementi per pagina.**  
+
+Per ottenere i successivi 500 elementi è necessario specificare il parametro `page` nell'URL.  
+È possibile personalizzare il numero di elementi per pagina tramite il parametro `pagesize` nell'URL (limitato comunque a massimo 500 elementi).  
+
+**Essendo gli endpoint `/regioni` e `/province` molto leggeri, non è necessario specificare il parametro `page` per ottenere tutti i risultati.**
+
 # Installazione su server proprio
 
 Tramite questa repo è possibile installare l'API su una propria istanza di Supabase.