Add Come fare le richieste

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"
+```