Les événements sont identifiés par leur identifiant unique (ID), qui est requis afin d'obtenir les détails complets d'un événement donné.

La requête de détail d'un événement vous permet d'obtenir davantage d'informations sur cet événement, dont un certain nombre d'élements additionnels qui ne sont pas présents dans une requête simple de listing, comme les différentes représentations, les différentes photos (s'il y a lieu), ou encore les différents tarifs.

GET https://api.amienscope.fr/get/event/<id>

En cas d'erreur, l'API renvoie un objet JSON spécifique (cf. Erreurs) :

{
	"error": { "err_num":"AEx0XX", "err_str":"Error Message" }
}

En cas de succès, l'API renvoie un objet JSON unique contenant l'ensemble des champs relatifs à cet événement :

{
	"id":"18",
	"add_dt":"1441288457",
	"lastmod_dt":"1441289120",
	"highlighted":"0",
	"favorite_count":"142",
	"visit_count":"2560",
	"event_revision_add_dt":"1441288457",
	"event_title":"Dee Dee Bridgewater et Irvin Mayfield",
	"event_description":"<p><strong>Dee Dee Bridgewater<\/strong> & <strong>Irvin Mayfield<\/strong> and the <strong>New Orleans Jazz Orchestra<\/strong>.<\/p>\r\n<p>Depuis quarante ans, Dee Dee Brigdewater charme de sa voix les amateurs de jazz. N\u00e9e \u00e0 Memphis au d\u00e9but des ann\u00e9es 50, c'est d'abord dans l'orchestre de son p\u00e8re Matthew Garret qu'elle illumine la sc\u00e8ne de sa pr\u00e9sence. Vingt ans plus tard, elle rencontre le trompettiste Cecil Bridgewater, dont elle gardera le nom, et devient le sourire de l'orchestre de Thad Jones et Mel Lewis. Dans le m\u00eame temps de Dizzy Gillespie \u00e0 Sonny Rollins, la chanteuse donne la r\u00e9plique aux plus grands.<\/p>",
	"event_description_additional": [
		{
			"id": "7",
			"description_type_id": "5",
			"description_field_name": "description_courte",
			"description_label": "Description Courte",
			"description_content": "Dee Dee Brigdewater charme de sa voix les amateurs de jazz."
		},
	],
	"event_url_info":"http:\/\/www.maisondelaculture-amiens.com",
	"event_status_label":"Publi\u00e9",
	"event_status_visible":"1",
	"address_location":"Maison de la Culture d'Amiens",
	"address_number":"2",
	"address_street_addr":"Place L\u00e9on Gontier",
	"address_addr_info":"",
	"address_latitude":"0.000000",
	"address_longitude":"0.000000",
	"city_name":"Amiens",
	"city_uri":"amiens",
	"city_postal_code":"80000",
	"city_latitude":"49.900002",
	"city_longitude":"2.300000",
	"state_code":"80",
	"state_name":"Somme",
	"state_uri":"somme",
	"audience_id":"1",
	"audience_label":"Tout public",
	"event_start_dt":"1443292200",
	"event_start_dt_iso":"2015-09-26",
	"event_end_dt":"1443292200",
	"event_end_dt_iso":"2015-09-26",
	"timetable":[
		"20:30:00",
		"22:45"
	],
	"datetable": [
		"2015-09-26",
	],
	"event_is_free":0,
	"fare_price_minimum":"29.500000",
	"fare_price_maximum":"38.500000",
	"booking_url":"http:\/\/ad.zanox.com\/ppc\/?27307540C15325197&ULP=[[\/place-spectacle\/manifestation\/Jazz-DEE-DEE-BRIDGEWATER--IRVIN-MAYFIELD-AM26S.htm]]",
	"accessibility":[
		{
			"accessibility_id":"1",
			"accessibility_icon_path":"http:\/\/www.amienscope.fr\/static\/im\/layout\/accessibility\/wheelchair.png",
			"accessibility_label":"Acc\u00e8s personnes \u00e0 mobilit\u00e9 r\u00e9duite",
			"accessibility_description":"L'\u00e9v\u00e9nement propose l'acc\u00e8s facilit\u00e9 aux personnes \u00e0 mobilit\u00e9 r\u00e9duite."
		},
		{
			"accessibility_id":"2",
			"accessibility_icon_path":"http:\/\/www.amienscope.fr\/static\/im\/layout\/accessibility\/audioguide.png",
			"accessibility_label":"Audio-guide",
			"accessibility_description":"L'\u00e9v\u00e9nement propose l'utilisation d'un audio-guide pour les personnes malvoyantes."
		}
	],
	"pictures":[
		{
			"picture_id":"174",
			"picture_add_dt":"1441288457",
			"picture_path":"2015\/09\/03\/dee-dee-bridgewater--ps212q.jpg",
			"picture_distant_url":"http:\/\/www.<api_domain>\/i\/300x300\/2015\/09\/03\/dee-dee-bridgewater--ps212q.jpg",
			"picture_fullsize_url":"http:\/\/www.<img_domain>\/static\/im\/event\/2015\/09\/03\/dee-dee-bridgewater--ps212q.jpg",
			"picture_base64":"http:\/\/www.<api_domain.com>\/get\/picture_base64\/174\/300x300"
		},
		{
			"picture_id":"418",
			"picture_add_dt":"1441288945",
			"picture_path":"2015\/09\/03\/dee-dee-bridgewater-123.jpg",
			"picture_distant_url":"http:\/\/www.<api_domain>\/i\/300x300\/2015\/09\/03\/dee-dee-bridgewater-123.jpg",
			"picture_fullsize_url":"http:\/\/www.<img_domain>\/static\/im\/event\/2015\/09\/03\/dee-dee-bridgewater-123.jpg",
			"picture_base64":"http:\/\/www.<api_domain.com>\/get\/picture_base64\/418\/300x300",
		}
	],
	"categories":[
		{
			"category_id":"4",
			"category_name":"Concert",
			"icon_filename":"ic_play_circle_filled_48px.svg",
			"icon_distant_url":"http:\/\/api.<api_domain>\/static\/im\/layout\/icons\/material-icons-svg\/ic_play_circle_filled_48px.svg"
		},
		{
			"category_id":"6",
			"category_name":"Spectacle",
			"icon_filename":"ic_accessibility_48px.svg",
			"icon_distant_url":"http:\/\/api.<api_domain>\/static\/im\/layout\/icons\/material-icons-svg\/ic_accessibility_48px.svg"
		}
	],
	"performances":[
		{
			"performance_id":"19",
			"performance_start_dt":"1443292200",
			"performance_end_dt":"1443292200",
			"performance_start_dt_iso":"2015-09-26 20:30:00",
			"performance_end_dt_iso":"2015-09-26 20:30:00",
			"fares":[
				{
					"fare_label":"Moins de 12 ans",
					"fare_price":"32.000000",
					"fare_info_text":"R\u00e9servation P.M.R. : 03.22.97.79.72.",
					"fare_booking_url":"http:\/\/ad.zanox.com\/ppc\/?27307540C15325197&ULP=[[\/place-spectacle\/manifestation\/Jazz-DEE-DEE-BRIDGEWATER--IRVIN-MAYFIELD-AM26S.htm]]",
					"currency_sign":"\u20ac",
					"currency_isocode":"EUR",
					"currency_name":"Euro"
				},
				{
					"fare_label":"Adulte",
					"fare_price":"38.500000",
					"fare_info_text":"R\u00e9servation P.M.R. : 03.22.97.79.72.",
					"fare_booking_url":"http:\/\/ad.zanox.com\/ppc\/?27307540C15325197&ULP=[[\/place-spectacle\/manifestation\/Jazz-DEE-DEE-BRIDGEWATER--IRVIN-MAYFIELD-AM26S.htm]]",
					"currency_sign":"\u20ac",
					"currency_isocode":"EUR",
					"currency_name":"Euro"
				}
			]
		},
		{
			"performance_id":"52",
			"performance_start_dt":"1444337100",
			"performance_end_dt":"1444337100",
			"performance_start_dt_iso":"2015-10-08 20:30:00",
			"performance_end_dt_iso":"2015-10-08 20:30:00",
			"fares":[
				{
					"fare_label":"Moins de 12 ans",
					"fare_price":"29.500000",
					"fare_info_text":"R\u00e9servation P.M.R. : 03.22.97.79.72.",
					"fare_booking_url":"http:\/\/ad.zanox.com\/ppc\/?27307540C15325197&ULP=[[\/place-spectacle\/manifestation\/Jazz-DEE-DEE-BRIDGEWATER--IRVIN-MAYFIELD-AM26S.htm]]",
					"currency_sign":"\u20ac",
					"currency_isocode":"EUR",
					"currency_name":"Euro"
				},
				{
					"fare_label":"Adulte",
					"fare_price":"34.500000",
					"fare_info_text":"R\u00e9servation P.M.R. : 03.22.97.79.72.",
					"fare_booking_url":"http:\/\/ad.zanox.com\/ppc\/?27307540C15325197&ULP=[[\/place-spectacle\/manifestation\/Jazz-DEE-DEE-BRIDGEWATER--IRVIN-MAYFIELD-AM26S.htm]]",
					"currency_sign":"\u20ac",
					"currency_isocode":"EUR",
					"currency_name":"Euro"
				}
			]
		}
	],
	"organiser":[
		{
			"id":"10",
			"name":"Z\u00e9nith Amiens",
			"phone":"03 22 48 01 75",
			"email":"reservation@zenith-amiens.fr",
			"website":"http:\/\/www.zenith-amiens.fr",
			"organiser_categories":[
				{
					"organiser_category_id":"6",
					"organiser_category_name":"Salles de Spectacle"
				}
			],
			"address_location":"Z\u00e9nith Amiens",
			"address_number":"",
			"address_street_addr":"Avenue de l'Hippodrome",
			"address_addr_info":"",
			"address_latitude":"0.000000",
			"address_longitude":"0.000000",
			"city_id":"32505",
			"city_name":"Amiens",
			"city_postal_code":"80000",
			"state_code":"80",
			"state_name":"Somme"
		}
	],
	"lang_name":"Fran\u00e7ais - France",
	"lang_locale":"fr_FR",
	"root_domain":"<api_domain>"
}
Champ Type Description
id int Identifiant unique de l'événement
add_dt timestamp Date d'ajout (timestamp UNIX) de l'événement
lastmod_dt timestamp Date de dernière modification (timestamp UNIX) de l'événement
highlighted bool 1 ou 0 : L'événement est mis « À la Une »
favorite_count int Nombre de fois où cet événement a été marqué comme « Favori » par les utilisateurs, dans leur application.
visit_count int Nombre de fois où le détail de cet événement a été ouvert dans l'application (ou nombre de visites). Utilisé pour le classement des événements les plus populaires.
event_revision_add_dt timestamp Date de dernière révision de l'événement (timestamp UNIX)
event_title str Titre de l'événement
event_description str Description de l'événement au format HTML
event_description_additional array

Tableau d'objets pouvant contenir des descriptions additionnelles pour l'événement (par exemple "Description courte", etc.). Les types de descriptions sont gérés dynamiquement par les administrateurs.

Chaque élément du tableau est composé des champs suivants :

id int Identifiant unique de la description
description_type_id int Identifiant unique du type de description
description_field_name str Nom du type de description au format URI
description_label str Nom du type de description au format lisible
description_content str Contenu de cette description additionnelle pour cet événement
event_url_info URL URL d'informations complémentaires (site officiel, etc.)
event_status_label str Statut/État de l'événement (« Publié » ou « Annulé »)
event_status_visible bool 1 ou 0 : l'événement est visible ou non dans l'API
address_location str Lieu où se déroule l'événement
address_number str Numéro de rue où se déroule l'événement
address_street_addr str Ligne 1 de l'adresse de l'événement (nom de la rue)
address_addr_info str Ligne 2 de l'adresse de l'événement (le cas échéant)
address_latitude timestamp Latitude GPS du lieu où se déroule l'événement
address_longitude timestamp Longitude GPS du lieu où se déroule l'événement
city_name str Nom de la ville où se déroule l'événement
city_uri str URI de la ville où se déroule l'événement
city_postal_code str Code postal de la ville où se déroule l'événement
city_latitude timestamp Latitude GPS de la ville au sens général (centre-ville)
city_longitude timestamp Longitude GPS de la ville au sens général (centre-ville)
state_code str Code du département dans lequel se déroule l'événement
state_name str Nom du département dans lequel se déroule l'événement
state_uri str URI du département dans lequel se déroule l'événement
audience_id int Identifiant unique de l'audience de l'événement (type de public visé)
audience_label str Nom/Libellé de l'audience de l'événement (type de public visé)
event_start_dt timestamp Date de début de l'événement (timestamp UNIX)
event_start_dt_iso date Date de début de l'événement au format ISO/SQL
event_end_dt timestamp Date de fin de l'événement (timestamp UNIX)
event_end_dt_iso date Date de fin de l'événement au format ISO/SQL
timetable array Tableau contenant toutes les horaires de représentation, toutes représentations confondues.
Si par exemple un concert est donné le 10 septembre à 18h30 et 22h00, et le 12 septembre à 18h30 et 20h30, ce tableau sera ["18:30","20:30","22:00"].
datetable array Tableau contenant tous les jours de représentation.
Si par exemple un concert est donné les 10 et 12 septembre, ainsi que le 4 octobre, ce tableau sera ["2015-09-10","2015-09-12","2015-10-04"].
event_is_free bool 1 ou 0 : L'événement est gratuit, ou ne l'est pas
fare_price_minimum float Tarif minimum pour cet événement, toutes représentations confondues
fare_price_maximum float Tarif maximum pour cet événement, toutes représentations confondues
booking_url URL Si applicable, l'adresse URL où il est possible de réserver en ligne pour cet événement
accessibility array

Tableau d'objets contenant les informations d'accessibilité auxquelles l'événement est attaché.

Chaque élément du tableau est composé des champs suivants :

accessibility_id int Identifiant unique de l'élément
accessibility_icon_path str Chemin de l'image (icône) correspondante
accessibility_label str Libellé de cette information d'accessibilité
accessibility_description str Description longue détaillant cette information d'accessibilité
pictures array

Tableau d'objets contenant toutes les photos/visuels de l'événement. Ce tableau peut être vide, ou ne contenir qu'un seul objet.

Chaque élément du tableau est composé des champs suivants :

picture_id int Identifiant unique de l'image
picture_add_dt timestamp Date d'ajout (timestamp UNIX) de cette image
picture_path str Chemin relatif de l'image
picture_distant_url URL URL absolue de l'image, recadrée à une dimension personnalisée.

Remarque : le segment /300x300/ présent par défaut dans l'URL peut être librement modifié afin d'obtenir un visuel aux dimensions que vous souhaitez. L'image retournée sera automatiquement recadrée en fonction, et retournée aux dimensions demandées.
picture_fullsize_url URL URL absolue de l'image, dans ses dimensions originales (non recadrée, et à sa taille maximale)
picture_base64 URL URL de requête à effectuer sur l'API pour obtenir l'image au format base64.

Remarque : le segment /300x300/ présent par défaut dans l'URL peut être librement modifié ou supprimé afin d'obtenir un visuel aux dimensions que vous souhaitez. L'image retournée sera automatiquement recadrée en fonction, et retournée aux dimensions demandées.

Si vous supprimez ce segment, les données renvoyées par cette URL (l'image en base64) concerneront l'image non recadrée, dans ses dimensions originales.
Exemple : https://www.<api_domain.com>/get/picture_base64/418
categories array

Tableau d'objets contenant toutes les catégories auxquelles l'événement est attaché.

Chaque élément du tableau est composé des champs suivants :

category_id int Identifiant unique de la catégorie
category_visible bool Catégorie active (visible), ou désactivée. Une catégorie désactivée ne doit pas être affichée.
category_name str Nom complet de la catégorie
icon_filename str Chemin relatif de l'icône associée (format SVG)
icon_distant_url str Chemin absolu (URL) de l'icône associée (format SVG)
performances array

Tableau d'objets contenant toutes les représentations de cet événement. Un événement peut avoir lieu plusieurs fois, dans le cadre de plusieurs représentations à différentes périodes d'intervalle.

Chaque élément du tableau est composé des champs suivants :

performance_id int Identifiant unique (ID) de la représentation
performance_start_dt timestamp Date de début (timestamp UNIX) de la représentation.
performance_end_dt timestamp Date de début (timestamp UNIX) de la représentation.
Si celle-ci est identique à la date de début de représentation, c'est que l'API ignore la durée de l'événement. Dans ce cas, il sera donc judicieux d'ignorer cette date de fin.
performance_start_dt_iso datetime Date et heure (au format ISO/SQL) de début de la représentation.
performance_end_dt_iso datetime Date et heure (au format ISO/SQL) de fin de la représentation.
Si celle-ci est identique à la date de début de représentation, c'est que l'API ignore la durée de l'événement. Dans ce cas, il sera donc judicieux d'ignorer cette date de fin.

Chaque représentation ("performance") peut disposer de tarifs ("fare") différents d'une représentation à l'autre.

Les tarifs sont donc liés à la représentation, et chaque objet performance contient un champ fares composé des éléments suivants :

fare_label str Libellé du tarif. Exemple : « Tarif réduit », « Plein tarif », « Moins de 12 ans » etc.
fare_price float Prix correspondant à ce tarif.
fare_info_text str Informations additionnelles (texte) au sujet de ce tarif. Infos réservations, etc.
fare_booking_url URL Si applicable, l'adresse URL où il est possible de réserver en ligne pour cette représentation.
fare_price float Prix correspondant à ce tarif.
currency_sign str Sigle monétaire de la devise utilisée pour ce tarif (défaut « € »)
currency_isocode str Code ISO monétaire de la devise utilisée pour ce tarif
currency_name str Nom lisible de la devise utilisée pour ce tarif
organiser array

Tableau d'objets contenant le (ou les) organisateur(s) de cet événement. Si aucun organisateur n'est renseigné, ce champ sera null.

Chaque élément du tableau est composé des champs suivants :

id int Identifiant de l'organisateur
name str Nom de l'organisateur (ou de structure)
phone str Numéro de téléphone de l'organisateur
website str URL de site Internet de l'organisateur
organiser_categories array Tableau des catégories/types dont l'organisateur fait partie
address_location str Lieu où est basé cet organisateur
address_number str Numéro de rue de l'adresse de l'organisateur
address_street_addr str Rue de l'adresse de l'organisateur
address_addr_info str Complément d'adresse de l'organisateur
address_latitude float Latitude (GPS) de l'adresse de l'organisateur
address_longitude float Longitude (GPS) de l'adresse de l'organisateur
city_id int Identifiant de la ville de l'organisateur
city_name str Ville de l'organisateur
city_postal_code str Code postal de l'organisateur
state_code str Numéro de département de l'organisateur
state_name str Département de l'organisateur
lang_name str Nom lisible de la langue d'enregistrement de cet événement
lang_locale str Nom ISO de la langue d'enregistrement de cet événement
localization array Données correspondant aux champs traduisibles. Les champs pouvant être multilingues seront retournés ici, dans un format dynamique dépendant de ces champs. En général, ce champ contient les versions traduites (en langue étrangère) de certains champs comme la description, les infos réservation, et les descriptions additionnelles.

Le format est de type tableau indexé par langue, chacun des éléments contenant des couples clé/valeur avec les informations de l'événement en langue étrangère. Les noms des clés ne sont pas fixes, car dépendant des choix des administrateurs (c'est pourquoi il n'est pas possible de fournir un exemple ; pensez à tester l'existence des clés/valeurs si vous exploitez ce champ).
root_domain str Domaine parent sur l'API

Certains champs seront systématiquement renseignés (car obligatoires), mais nombreux sont les champs qui peuvent être vides. Si tel est le cas, le champ résultant contiendra tout simplement null.
/get/categories
Catégories d'événements utilisées dans l'API
/get/organisers
Organisateurs d'événements connus de l'API
/get/events/<id>
Événements présents dans une catégorie donnée
/get/from_organiser/<id>
Événements d'un organisateur donné
/get/audiences
Liste des publics visés utilisés par les événements
/get/updates/<time>
Événements mis à jour ou modifiés depuis une date donnée
/get/highlights
Événements mis en avant par la collectivité (ou « À la Une »)
/get/recent
Événements ajoutés le plus récemment
/get/next
Prochains événements à venir, sans distinction de catégorie
/search/<criteria>
Recherche d'événements par critères spécifiques
/get/popular
Événements les plus populaires
/get/accessibilities
Liste des formes d'accessibilité disponibles
/get/from_accessibility
Liste d'événements correspondant à une forme d'accessibilité