https://github.com/axiostudio/comuni-italiani
Pacchetto Laravel per la gestione dei comuni italiani
https://github.com/axiostudio/comuni-italiani
amministrazione api burocrazia cities citta comuni italia italian laravel package php strumenti tools
Last synced: 5 months ago
JSON representation
Pacchetto Laravel per la gestione dei comuni italiani
- Host: GitHub
- URL: https://github.com/axiostudio/comuni-italiani
- Owner: axiostudio
- Created: 2024-02-05T15:07:04.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-12T15:51:43.000Z (6 months ago)
- Last Synced: 2025-12-14T06:12:00.496Z (6 months ago)
- Topics: amministrazione, api, burocrazia, cities, citta, comuni, italia, italian, laravel, package, php, strumenti, tools
- Language: PHP
- Homepage:
- Size: 1.4 MB
- Stars: 9
- Watchers: 3
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Axio Studio Comuni
## Informazioni
Questo package Laravel include delle API utili a fruire delle informazioni riguardanti i comuni italiani.
## Come funziona
Grazie a comode API è possibile ottenere informazioni di CAP, città, provincie, regioni e zone d'Italia.
| Endpoint | Metodo | Descrizione | Parametri |
| ---------------------------- | ------ | ------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| /api/comuni/zones | GET | Ritorna una lista di tutte le zone italiane | - |
| /api/comuni/zones/{id} | GET | Ritorna le informazioni di una determinata zona in base al suo "id" | - |
| /api/comuni/regions | GET | Ritorna la lista di tutte le regioni italiane | - |
| /api/comuni/regions/{id} | GET | Ritorna le informazioni di una determinata regione in base al suo "id" | - |
| /api/comuni/provinces | GET | Ritorna la lista di tutte le regioni italiane | q (querystring) - filtra per nome dopo il terzo carattere di ricerca |
| /api/comuni/provinces/{id} | GET | Ritorna le informazioni di una determinata regione in base al suo "id" | - |
| /api/comuni/provinces/{code} | GET | Ritorna le informazioni di una determinata regione in base al suo "code" | - |
| /api/comuni/cities | GET | Ritorna la lista di tutte le città italiane | q (querystring) - filtra per nome dopo il terzo carattere di ricerca |
| /api/comuni/cities/{id} | GET | Ritorna le informazioni di una determinata città in base al suo "id" | - |
| /api/comuni/zips | GET | Ritorna la lista di tutti i CAP italiani | q (querystring) - filtra per codice (5 caratteri numerici) |
| /api/comuni/zips/{id} | GET | Ritorna le informazioni di un determinato CAP in base al suo "id" | - |
## Installazione
Per installare il package, eseguire:
```bash
composer require axiostudio/comuni-italiani
```
Per completare l'installazione è necessario avviare le migration ed eseguire:
```bash
php artisan migrate && php artisan comuni:update
```
## Personalizzazione
È possibile esportare nel proprio progetto il file config e le migrations del package tramite:
```bash
php artisan vendor:publish --provider="Axiostudio\Comuni\ComuniServiceProvider"
```
## Note
Per supporto o bug utilizzare le Issue di Github, per collaborare invece è sufficente aprire un PR con le specifiche dell'integrazione eseguita.
## Credits
Questo pacchetto è stato creato ed è mantenuto da Axio Studio, per maggiori informazioni: https://axio.studio.