Détail d'un événement

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é

Requête sur l'API

Valeurs de retour

Détail des champs retournés

Voir aussi