commit cf7a42c5361fe13b12e4dc8f201fdefdbc13293c Author: Mr_sl1d3r Date: Tue Jun 3 18:29:53 2025 +0000 Add Come fare le richieste diff --git a/Come-fare-le-richieste.md b/Come-fare-le-richieste.md new file mode 100644 index 0000000..84fb376 --- /dev/null +++ b/Come-fare-le-richieste.md @@ -0,0 +1,50 @@ +# AMT API + +## API endpoints + +> Tutti gli endpoint richiedono autenticazione tramite token Bearer nell'header della richiesta. + + + +### Dati di trasporto + +#### Arrivi in tempo reale +- **GET /api/amt/transiti/{codiceFermata}** - Ottieni gli arrivi in tempo reale per una fermata + - Utilizza prima l'API XML e, in caso di errore, passa automaticamente allo scraping HTML + - Il codice fermata deve essere di 4 cifre + - Esempio: `/api/amt/transiti/0273` + +#### Orari delle linee +- **GET /api/amt/orari/{linea}** - Ottieni gli orari completi di una linea specifica + - Parametri opzionali per specificare la data: + - `gg`: Giorno (formato: DD) + - `mm`: Mese (formato: MM) + - `aa`: Anno (formato: YYYY) + - Se i parametri di data non sono specificati, viene utilizzata la data corrente + - Restituisce informazioni dettagliate sulle tratte, destinazioni e orari di partenza + - Esempio: `/api/amt/orari/53?gg=29&mm=04&aa=2025` + +#### News e avvisi +- **GET /api/amt/news** - Ottieni l'elenco delle ultime news e avvisi di servizio + - Parametro opzionale `limit` per specificare il numero massimo di news da restituire + - Restituisce titolo, data di pubblicazione e ID per ogni news + - Esempio: `/api/amt/news?limit=10` + +- **GET /api/amt/news/{id}** - Ottieni i dettagli completi di una news specifica + - Restituisce il contenuto HTML, le immagini e i link presenti nella news + - Utile per visualizzare avvisi di servizio, modifiche di percorso e altre comunicazioni + - Esempio: `/api/amt/news/49413` + +#### Stato del servizio +- **GET /api/amt/stato-servizio** - Ottieni lo stato attuale del servizio AMT + - Fornisce informazioni in tempo reale su interruzioni, deviazioni e modifiche al servizio + - Include dettagli su ascensori, funicolari, ferrovia Genova-Casella e linee bus + - I dati sono categorizzati per tipo di servizio e includono causa, messaggio e data dell'evento + - Esempio: `/api/amt/stato-servizio` + +#### Esempio con cURL + +```bash +curl -X GET "https://api.trasportizenesi.it/api/amt/transiti/0273" \ + -H "Authorization: Bearer il_tuo_token_qui" +``` \ No newline at end of file