5 End-point
Mr_sl1d3r edited this page 2025-06-14 13:14:24 +00:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Documentazione API - AMT Genova (Versione 1)

Base URL

https://api.trasportizenesi.it/api/v1/

GET /fermate/:codicelinea

Restituisce tutte le fermate per la linea specificata.

Esempio richiesta:

GET /fermate/001-00

Esempio risposta:

{
  "codice_linea": "001-00",
  "andata": [
    {
      "codice_linea": "001-00",
      "direzione": "1",
      "codice_fermata": "0170",
      "ordine": 1
    },
    {
      "codice_linea": "001-00",
      "direzione": "1",
      "codice_fermata": "0003",
      "ordine": 2
    }
  ]
}

GET /linee

Restituisce tutte le linee disponibili.

Esempio risposta:

[
  {
    "codice": "001-00",
    "numero": "1",
    "capolinea_andata": "Caricamento (Ponente)",
    "capolinea_ritorno": "Via Camozzini (Voltri)",
    "attiva": true,
    "note": ""
  },
  {
    "codice": "003-00",
    "numero": "3",
    "capolinea_andata": "Staz. Principe",
    "capolinea_ritorno": "Via Soliman (Sestri)",
    "attiva": true,
    "note": ""
  }
]

GET /news

Restituisce le notizie sul servizio

Esempio richista:

GET /news

Esempio risposta:

[
	{
		"id": "49461",
		"titolo": "Linee 715, 725 e 726, temporanea variazione di percorso lunedì 9 giugno",
		"data": "2025-06-06T13:57:00.000Z",
		"data_formattata": "06/06/2025 15:57"
	},
	{
		"id": "49449",
		"titolo": "Metropolitana: il programma delle attività di manutenzione serale previsto da lunedì 9 a giovedì 12 giugno",
		"data": "2025-06-06T13:26:00.000Z",
		"data_formattata": "06/06/2025 15:26"
	},
  }
]

GET /news/:id

Restituisce la notizia completa

Esempio richista:

GET /news/49461

Esempio risposta:

{
	"titolo": "News",
	"contenuto": "Da martedì 3 giugno lascensore di Quezzi sarà sottoposto a una serie di articolate attività legate alla manutenzione straordinaria e alla revisione generale dellimpianto. Allo scadere dei 10 anni di esercizio, come previsto dalla normativa vigente, è obbligatorio eseguire una serie di controlli ad ampio raggio su parti in movimento e componenti a terra dellimpianto. Verranno inoltre eseguiti interventi sulle parti elettriche e meccaniche e verifiche sulle principali componenti connesse alle funzioni di sicurezza dellesercizio. Per consentire lesecuzione di tali complesse attività, la cui durata è stimata in circa due mesi, lascensore sospende il servizio al pubblico. Per raggiungere via Pinetti e via Fontanarossa è possibile utilizzare la linea 82 (Chiesa di Quezzi - Staz. Brignole).",
	"data": "2025-06-14"
}

GET /orari/:codice_linea/:data

Restituisce gli orari previsti per una determinata linea e giorno.

Esempio richiesta:

GET /orari/051/2025-06-09

Esempio risposta:

{
  "linea": "051",
  "data": "2025-06-09",
  "servizi": [
    {
      "codice": "51",
      "barrato": false,
      "targa": "LINEA  51",
      "descrizione": "Sestri (Via Biancheri) - Via Rollino",
      "tratte": {
        "andata": {
          "descrizione": "Via Biancheri (Sestri) ---> Via Rollino",
          "partenze": ["05:45"]
        }
      }
    }
  ]
}

GET /passaggi/:codice_fermata

Restituisce i prossimi transiti e i tempi di attesa alla fermata.

Esempio richiesta:

GET /passaggi/0045

Esempio risposta:

{
  "codice_fermata": "0045",
  "timestamp": "2025-06-08T06:25:15.175Z",
  "passaggi": [
    {
      "linea": "001/",
      "destinazione": "VOLTRI",
      "orario": "08:32:52",
      "attesa": "8'",
      "teorico": false,
      "id_corsa": "09172",
      "pieno": false
    },
    {
      "linea": "192",
      "destinazione": "VOLTRI FS",
      "orario": "08:34:22",
      "attesa": "9'",
      "teorico": false,
      "id_corsa": "07063",
      "pieno": false
    }
  ]
}

GET /stato_servizio

Restituisce lo stato del servizio e l

Esempio richista:

GET /stato_servizio

Esempio risposta:

{
	"stato": [
		{
			"evento": "DEV",
			"categoria": "SG",
			"linee": [
				"15",
				"31",
				"42"
			],
			"causa": "interruzione della viabilità",
			"messaggio": "via brigata liguria,linee 15,31,42: dalle 7:00 del 8/6/2025 fino alle 14:00 del 8/6/2025 il servizio e' deviato su percorsi alternativi causa interruzione della viabilità.",
			"data": "8/6/2025 07:00"
		},
		{
			"evento": "GEV",
			"categoria": "SG",
			"messaggio": "Servizio bus: raduno moto storiche, linee 87, 88, 687 e i taxibus t18 e t18/ effettuano capolinea provvisorio sulla fermata di transito in piazza pitto (codice 1497).",
			"data": "7/6/2025 00:01"
		},
    ]
 }

GET /stato_servizio/categoria/:categoria

Restituisce lo stato del servizio di una determinata categoria

Esempio richista:

GET /stato_servizio/categoria/ASC

Esempio risposta:

{
	"stato": [
		{
			"evento": "FERS",
			"categoria": "ASC",
			"linee": "Ascensore di piazza Manin",
			"causa": "caduta calcinacci",
			"messaggio": "Ascensore di piazza Manin: il servizio è temporaneamente sospeso causa caduta calcinacci. ",
			"data": "4/6/2025 15:04"
		},
		{
			"evento": "FERS",
			"categoria": "ASC",
			"linee": "Ascensore di Quezzi",
			"causa": "manutenzione",
			"messaggio": "Ascensore di Quezzi: dalle 6:50 del 3/6/2025 il servizio è temporaneamente sospeso causa manutenzione. ",
			"data": "3/6/2025 06:50"
		},
		{
			"evento": "FERS",
			"categoria": "ASC",
			"linee": "Ascensore Cantore-Scassi",
			"causa": "problemi tecnici",
			"messaggio": "Ascensore Cantore-Scassi: il servizio è temporaneamente sospeso causa problemi tecnici. ",
			"data": "4/12/2022 10:06"
		}
	]
}

Limiti di utilizzo

  • Senza token: massimo 60 richieste al minuto.
  • Con token: massimo 300 richieste al minuto (prioritarie).