OpenData Emilia Romagna Turismo (1.0.0)

Download OpenAPI specification:Download

Stefano Vena: emiliaromagnaturismo@aptservizi.com URL: https://emiliaromagnaturismo.it/it/chi-siamo License: Attribuzione 4.0 Internazionale Terms of Service

Questa API permette di consultare i dati che il portale Emilia-Romagna Turismo rende disponibili a tutti gli utenti per favorire il riutilizzo e la nascita di applicazioni da parte di nuovi soggetti e sono rilasciati in (licenza CC-BY)[https://creativecommons.org/licenses/by/4.0/deed.it].

I dati scaricabili da Emilia-Romagna Turismo possono essere utilizzati per ogni scopo, personale o commerciale, senza alcuna limitazione se non la citazione della fonte e vengono aggiornati dalle Redazioni Locali del Sistema Turistico Regionale con cadenza regolare.

La sezione General raccoglie tutti gli endpoint disponibili del portale Emilia Romagna Turismo a cui è possibile richiedere dati. La sezione Tassonomie espone la struttura interna del Portale Emilia Romagna Turismo secondo cui è possibile filtrare le proprie richieste all’API.

General

Tutti i dati del portale emilia romagna turismo in opendata

Ritorna lo stato dell'applicazione.

Ritorna lo stato dell'applicazione. A scopo di test, su base randomica puo' ritornare un errore.

Responses

Response samples

400
429
503
default

Content type

application/problem+json

{"detail": "Request took too long to complete.",
"instance": "http://example.com",
"status": 503,
"title": "Service Unavailable",
"type": "https://tools.ietf.org/html/rfc7231#section-6.6.4"
}

Località

Elenco delle località.

query Parameters

lang	string <= 2 characters Example: lang=it Lingua
istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339
query	string <= 255 characters Example: query=Bologna Ricerca con testo libero

Responses

Elenco uffici IAT

Elenco degli uffici di Informazioni e Accoglienza Turistica.

query Parameters

istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

Events

Elenco degli eventi attualmente presenti sul portale di emilia romagna turismo.

query Parameters

lang	string <= 2 characters Example: lang=it Lingua
istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
city	string <= 255 characters Example: city=ravenna Filtro per nome della città, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
theme	string <= 6 characters Example: theme=5009 Codice del tematismo per il quale filtrare
category	string <= 6 characters Example: category=1005 Codice della categoria per la quale filtrare
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

News

Elenco delle news.

query Parameters

lang	string <= 2 characters Example: lang=it Lingua
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare

Responses

Interessi

Elenco delle schede interesse del sito della Regione Emilia Romagna.

query Parameters

lang	string <= 2 characters Example: lang=it Lingua
istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

Itinerari

Elenco di tutti gli itinerari attualmente disponibili.

query Parameters

time	integer <int32> [ 24 .. 72 ] Enum: 24 48 72 Example: time=48 I valori disponibili sono 24,48,72
lang	string <= 2 characters Example: lang=it Lingua
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

Point of Interest

Collezione di punti di interesse.

path Parameters

code

required

string <= 255 characters

Codice identificativo della collezione.

query Parameters

istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

Images

Elenco delle immagini accessibili liberamente e inserite nel database di OpenLibrary

query Parameters

limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare

Responses

WebCam

Elenco delle webcam pubbliche disponibili.

query Parameters

page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina

Responses

Taxonomies

Tassonomie del portale emilia romagna turismo in opendata

Cities

Elenco dei comuni disponibili con informazioni sulle province.

query Parameters

istat	string <= 6 characters Example: istat=37001 Codice Istat identificativo del comune
prov	string <= 2 characters Example: prov=BO Filtro per nome della provincia, consulta l'endpoint dei comuni per l'elenco di province e comuni supportati
query	string <= 255 characters Example: query=Bologna Ricerca con testo libero

Responses

Categorie Eventi

Elenco delle categorie degli eventi. Gli eventi oltre ai tematismi hanno una loro tassonomia esclusiva.

query Parameters

lang	string <= 2 characters Example: lang=it Lingua

Responses

Tematismi

Elenco degli elementi della tassonomia tematismi

query Parameters

lang	string <= 2 characters Example: lang=it Lingua

Responses

Target

Elenco degli elementi della tassonomia target

query Parameters

lang	string <= 2 characters Example: lang=it Lingua

Responses

Languages

Elenco delle lingue supportate.

Responses

Point of Interest

Elenco delle collezioni di punti di interesse (poi) disponibili.

query Parameters

limit	integer <int32> [ -1 .. 1000 ] Example: limit=1 Numero di risultati da restituire per ogni pagina
page	integer <int32> [ 1 .. 99999999 ] Example: page=1 Numero di pagina da interrogare
updated	string <= 23 characters Example: updated=2020-10-06T07:20:50.50Z Data di aggiornamento. Vengono restituiti tutti i contenuti che siano stati modificati dopo la data inserita. La data va inserita in formato rfc3339

Responses

Eventi

Tutti i dati del portale emilia romagna turismo in opendata

nuovo evento

Invia evento al portale

Authorizations:

bearerAuth

header Parameters

Accept-Language

string

Default: it-IT

Example: it-IT

La lingua preferita per i messaggi di sistema. I valori supportati sono it-IT, en-GB, en-US

Request Body schema: application/json

	object
	Array of objects
	object
	object
	object
	Array of objects (categorie eventi)
	Array of objects
	object
	Array of objects
	Array of objects (portal) portale di destinazione

Responses

Request samples

Payload

Content type

application/json

{"contents": {"it": {"title": "Diverdeinverde",
"slug": "6772-diverdeinverde-giardini-aperti",
"subtitle": "string",
"canonical": "https://www.bolognawelcome.com/en/events/trekking/diverdeinverde-open-gardens",
"pub_date": "2023-02-22 00:00:00",
"description": "Due giorni per scoprire che <strong>Bologna</strong> è un giardino. <br />Ogni anno, in maggio, Bologna apre alla visita i portoni e i cancelli di numerosi giardini privati",
"google": {"title": "Diverdeinverde - Giardini aperti",
"keywords": "Diverdeinverde - Giardini aperti",
"description": "string"
}
}
},
"locations": [{"address": "viale Guglielmo Marconi",
"number": 12,
"lat": 12.34,
"lng": 56.78,
"locality_id": 125,
"city": {"id": 194,
"name": "Bologna",
"province": "Bologna",
"info": {"it": "info extra luogo IT",
"en": "info extra luogo EN"
}
}
}
],
"dates": {"start": "2023/05/27",
"end": "2023/05/28",
"dates": ["2023/05/27",
"2023/05/28"
],
"week": [0,
0,
0,
0,
0,
1,
1
]
},
"times": {"type": "freetext",
"freetext": {"it": "Descrizione generica degli orari IT",
"en": "Descrizione generica degli orari EN"
}
},
"contacts": {"it": [{"label": "string",
"type": "telephone",
"value": "string"
}
]
},
"category": [{"id": 1010,
"name": "Mostre"
},
{"id": 1001,
"name": "Cinema"
}
],
"attachments": [{"url": "http://d2fg1aan4gy9m1.cloudfront.net/ert/images/4928/Cervia-%28RA%29%2C-Teatro-Comunale-Walter-Chiari%2C-rosone%2C-Archivio-Comune-Cervia-CC-BY-NC-SA-4.0.jpg",
"url_thumb": "http://d2fg1aan4gy9m1.cloudfront.net/ert/images/4928/conversions/Cervia-%28RA%29%2C-Teatro-Comunale-Walter-Chiari%2C-rosone%2C-Archivio-Comune-Cervia-CC-BY-NC-SA-4.0-thumb.jpg",
"title": "string",
"copyright": "Cervia (RA), Teatro Comunale Walter Chiari, rosone, Archivio Comune Cervia",
"license": "string",
"license_url": "string",
"is_primary": 0
}
],
"ticketing": {"ingresso": 1,
"info": {"it": {"tariffa_intera": "10 EUR",
"tariffa_gratuita": "bambini sotto i 14 anni",
"tariffa_ridotta": "universitari",
"tariffa_abbonamenti": "5 EUR",
"sito": "https://www.sitoweb.it/evento"
},
"en": {"tariffa_intera": "10 EUR",
"tariffa_gratuita": "children under 14",
"tariffa_ridotta": "student",
"tariffa_abbonamenti": "ticket description",
"sito": "https://www.sitoweb.it/evento"
}
}
},
"theme": [{"id": 5009,
"name": "Arte & Cultura"
}
],
"portal": [{"active": 1,
"name": "Emilia-Romagna"
}
]
}

Response samples

200
400
429
503
default

Content type

application/problem+json

{"status": "success",
"code": 200,
"data": {"id": 39102,
"permalink": "https://www.emiliaromagnaturismo.it/it/eventi/39102/6772-diverdeinverde-giardini-aperti",
"message": "Scheda salvata con successo"
}
}

aggiorna evento

Invia evento al portale

Authorizations:

bearerAuth

header Parameters

Accept-Language

string

Default: it-IT

Example: it-IT

La lingua preferita per i messaggi di sistema. I valori supportati sono it-IT, en-GB, en-US

Request Body schema: application/json

	object
	Array of objects
	object
	object
	object
	Array of objects (categorie eventi)
	Array of objects
	object
	Array of objects
	Array of objects (portal) portale di destinazione

Responses

Request samples

Payload

Content type

application/json

{"contents": {"it": {"title": "Diverdeinverde",
"slug": "6772-diverdeinverde-giardini-aperti",
"subtitle": "string",
"canonical": "https://www.bolognawelcome.com/en/events/trekking/diverdeinverde-open-gardens",
"pub_date": "2023-02-22 00:00:00",
"description": "Due giorni per scoprire che <strong>Bologna</strong> è un giardino. <br />Ogni anno, in maggio, Bologna apre alla visita i portoni e i cancelli di numerosi giardini privati",
"google": {"title": "Diverdeinverde - Giardini aperti",
"keywords": "Diverdeinverde - Giardini aperti",
"description": "string"
}
}
},
"locations": [{"address": "viale Guglielmo Marconi",
"number": 12,
"lat": 12.34,
"lng": 56.78,
"locality_id": 125,
"city": {"id": 194,
"name": "Bologna",
"province": "Bologna",
"info": {"it": "info extra luogo IT",
"en": "info extra luogo EN"
}
}
}
],
"dates": {"start": "2023/05/27",
"end": "2023/05/28",
"dates": ["2023/05/27",
"2023/05/28"
],
"week": [0,
0,
0,
0,
0,
1,
1
]
},
"times": {"type": "freetext",
"freetext": {"it": "Descrizione generica degli orari IT",
"en": "Descrizione generica degli orari EN"
}
},
"contacts": {"it": [{"label": "string",
"type": "telephone",
"value": "string"
}
]
},
"category": [{"id": 1010,
"name": "Mostre"
},
{"id": 1001,
"name": "Cinema"
}
],
"attachments": [{"url": "http://d2fg1aan4gy9m1.cloudfront.net/ert/images/4928/Cervia-%28RA%29%2C-Teatro-Comunale-Walter-Chiari%2C-rosone%2C-Archivio-Comune-Cervia-CC-BY-NC-SA-4.0.jpg",
"url_thumb": "http://d2fg1aan4gy9m1.cloudfront.net/ert/images/4928/conversions/Cervia-%28RA%29%2C-Teatro-Comunale-Walter-Chiari%2C-rosone%2C-Archivio-Comune-Cervia-CC-BY-NC-SA-4.0-thumb.jpg",
"title": "string",
"copyright": "Cervia (RA), Teatro Comunale Walter Chiari, rosone, Archivio Comune Cervia",
"license": "string",
"license_url": "string",
"is_primary": 0
}
],
"ticketing": {"ingresso": 1,
"info": {"it": {"tariffa_intera": "10 EUR",
"tariffa_gratuita": "bambini sotto i 14 anni",
"tariffa_ridotta": "universitari",
"tariffa_abbonamenti": "5 EUR",
"sito": "https://www.sitoweb.it/evento"
},
"en": {"tariffa_intera": "10 EUR",
"tariffa_gratuita": "children under 14",
"tariffa_ridotta": "student",
"tariffa_abbonamenti": "ticket description",
"sito": "https://www.sitoweb.it/evento"
}
}
},
"theme": [{"id": 5009,
"name": "Arte & Cultura"
}
],
"portal": [{"active": 1,
"name": "Emilia-Romagna"
}
]
}

Response samples

200
400
429
503
default

Content type

application/problem+json

{"status": "success",
"code": 200,
"data": {"id": 39102,
"permalink": "https://www.emiliaromagnaturismo.it/it/eventi/39102/6772-diverdeinverde-giardini-aperti",
"message": "Scheda salvata con successo"
}
}

lista eventi per utente

Recupera gli eventi presenti in piattaforma della redazione relativa all'utente che richiama le API

Authorizations:

bearerAuth

Responses

Response samples

200
400
429
503
default

Content type

application/problem+json

{"data": {"id": 123456,
"title": "Diverdeinverde",
"user": "Mario Rossi",
"redazione": "RL di Rimini",
"status": 1,
"created_at": "2023-02-22 00:00:00",
"updated_at": "2023-02-22 00:00:00"
}
}

Authentication

login

accesso portale

Authorizations:

bearerAuth

Request Body schema: application/json

username required	string >= 4 characters
password required	string <password> >= 8 characters /(?=.[a-z])(?=.[A-Z])(?=.*[0-9])/

Responses

Request samples

Payload

Content type

application/json

{"username": "redazionelocale",
"password": 1234
}

Response samples

200
400
404
429
503

Content type

application/problem+json

{"status": "success",
"code": 200,
"data": {"token_type": "Bearer",
"access_token": "XXXXXXXX"
}
}