Service get_locationsplus

 

 

Description

Service permettant d'obtenir une liste à jour des emplacements disponibles, selon un secteur spécifique, ainsi que la prochaine représentation qui sera diffusée à l'emplacement. Ce service prend les paramètres directement par le biais de l'hyperlien, au format GET.

 

Exemple d’utilisation :

http://[URL]/lavitrinejsonapi?key=d41d8cd98f00b204e9800998ecf8427e&command=get_locationsplus&lang=fr

 

Paramètres acceptés :

command : get_locationsplus
id : Référence au numéro d'identification unique de l'emplacement souhaité.
lang : La langue des informations retournées (titre, résumé, etc.). Si ce paramètre est inexistant ou non valide, la valeur « fr » est assumée. Les valeurs permises sont « fr » et « en ».
withShowing : Permet d’afficher seulement les emplacements qui ont présentement une ou des représentations (showings). La valeur 0 fournie au paramètre retourne la liste les locations peu importe s’ils ont des représentations (showing) ou non. La valeur 1 fournie au paramètre retourne la liste des locations qui ont actuellement des représentations (showing). Si ce paramètre n’est pas fourni, la valeur 1 sera utilisée par défaut.
sector : Ce paramètre accepte un secteur numérique (sector_id) et filtre le résultat selon ce dernier. Ce paramètre est obligatoire. S’il n’est pas fourni, la requête retournera une erreur.
organisme : Référence au nom d’organisme qui sert à filtrer les résultats de recherche.
lastModification : Référence à la date de dernière modification. Le format accepté est : YYYY-MM-DD-HH-MM. Ex: lastModification=2013-04-29-15-45.

 

Réponse :

 

 

phone : Numéro de téléphone de l’emplacement.
contact_email : Courriel de la personne ressource de l'emplacement.
id : Référence au numéro d'identification unique de l'emplacement souhaité.
title : Nom de l’emplacement (français ou anglais).
sector_id : Numéro d'identification du secteur.
sector : Nom du secteur de l'emplacement.
sub_sector_id : Numéro d'identification du sous-secteur.
sub_sector : Le nom du sous-secteur où se trouve l'emplacement.
image_url : URL de l’image principale reliée à l’emplacement.
description : Description de l’emplacement.
contact_name : Nom de la personne contact de l'emplacement.
disability : Information concernant l'accès en fauteuil roulant.
longitude : Coordonnée géographique (Est-Ouest).
tollfree_number : Numéro sans frais.
fax : Numéro du fax.
location_map : Hyperlien de la carte de l'emplacement.
website : Hyperlien de site web de l'emplacement.
hearing_impaired : Fanion indiquant si l'emplacement a des écouteurs pour malentendants.
contact_phone : Numéro de téléphone de la personne contact de l'emplacement.
pricing : Description de la tarification de l'emplacement.
proximity : Précision des attraits près de l'emplacement.
adress : Adresse de l’emplacement.
route : Trajet possible pour se rendre à l'emplacement.
latitude : Coordonnée géographique (Nord-Sud).
sef_url : URL qui mène vers l’emplacement sur le site de La Vitrine.
medias : Liste des médias associés à l'emplacement.
id : Numéro d'identification unique du média.
idLowResRef : ID de référence de l’image basse résolution associée à une image de haute résolution.
media_url : URL qui pointe vers le média.
media_copyright: Copyright du média.
type : Type du média. Les valeurs possibles sont : audio, image, video, video_externe.
activities : Informations sur la prochaine activité.
id : Numéro d'identification unique de l'activité.
title : Titre de l'activité (français ou anglais).
discipline_id : Numéro d'identification unique de la discipline.
discipline : Nom de la discipline.
sub_discipline_id : Numéro d'identification de la sous discipline.
sub_discipline : Nom de la sous discipline (français ou anglais).
is_quebec : Indique si l'activité est classée comme « québécoise ».
next_showing : Informations sur la prochaine représentation.
showing_time : Heure de la représentation sous le format : 0000
url_billeterie :
location_name : Nom de l’emplacement (français ou anglais).
rating_name : Nom du classement (français ou anglais).
activity_id : Numéro d'identification unique de l'activité.
type : Type de représentation. 0 est un spectacle, 1 est une exposition.
permanent_exposition : Indique si c'est une exposition permanente.
boxoffice_url : Hyperlien vers le système d'achat en ligne (français ou anglais).
last_minute_price : Prix billet à rabais si disponible.
presale_price : Prix billet à rabais si disponible.
location_id : Numéro d'identification unique de l'emplacement.
location_sef_url : Référence hyperlien à l’emplacement. Permet d’accéder directement à la description de l’emplacement via le site de La Vitrine.
end_date : Date de fin de la représentation.
regular_price : Prix régulier des billets si disponible.
url_last_minute : Hyperlien vers le système d'achat en ligne de dernière minute (français ou anglais).
last_minute : Fanion précisant si le statut est « dernière minute » 0 faux | 1 vrai.
presale : Fanion précisant si le statut est « prévente » 0 faux | 1 vrai.
start_date : Date de début de la représentation.
event_sef_url : Référence hyperlien à l'événement associé à l'activité. Permet d’accéder directement à la description de l’événement via le site de La Vitrine.
event_id : Numéro d'identification de l'événement associé à l'activité. Si aucun événement n'est associé à l'activité, la réponse retournée sera "null".
event_name : Nom de l'événement (français ou anglais).