Service get_activity

 

 

Descritpion

Service permettant d'obtenir le détail d'une activité. Il prend les paramètres directement par le biais de l'hyperlien, au format GET.

 

Exemple d'utilisation :

http://[URL]/lavitrinejsonapi?key=[KEY]&command=get_activity&id=1&lang=fr

 

Paramètres acceptés :

id : Référence au numéro d'identification unique de l'activité souhaitée. Cette valeur est obligatoire et requise.
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 ».
organisme : Référence à l'identifiant de l’organisme qui sert à filtrer les résultats de recherche.

 

Réponse :

 

Retourne la liste des représentations de l'activité correspondante triées par ordre chronologique sur la date de début. Le détail de l'activité inclut les informations suivantes :

 

command : get_activity
id : Numéro d'identification unique de l'activité.
title : Titre de l'activité (français ou anglais).
description : Description de l'activité (français ou anglais).
is_quebec : Indique si l'activité est classée « québécoise ».
image_url : Référence hyperlien à une vignette illustrant l'activité (200 x 200 pixels) . Si aucune image n’est disponible pour l’activité, l’image de la discipline est fournie, si aucune image n’est fournie pour la discipline, une image « place holder » est fournie.
sef_url : Référence hyperlien à l’activité. Permet d’accéder directement à la description de l’activité via le site de La Vitrine.
activityUrl : Hyperlien externe vers le site de l'activité.
producerName : Nom du producteur.
discipline : Nom de la discipline de l'activité (français ou anglais).
discipline_id : Numéro d'identification de la discipline de l'activité.
sub_discipline_id: Numéro d'identification de la sous discipline.
sub_discipline : Nom de la sous discipline (français ou anglais).
showing : Liste des représentations associées à l'activité en ordre croissant de date de début.
id : Numéro d'identification unique de la représentation.
lastminute_price : Prix billet à rabais si disponible.
presale_price : Prix billet à rabais si disponible.
showing_time : Heure de la réprésentation sous la forme de 4 digits.
permanent_exposition: Indique si c'est une exposition permanente.
end_date : Date de fin de la représentation.
regular_price : Prix régulier des billets si disponible.
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 du début de la représentation.
boxoffice_url : Hyperlien de redirection vers le système d'achat en ligne (français ou anglais).
boxoffice_url_direct : Hyperlien direct vers le système d'achat en ligne (français ou anglais).
rating_name : Nom du classement (français ou anglais).
last_modification : Date de dernière modification de la représentation.
canceled : Fanion précisant si la représentation est annulée ou non 0 false | 1 true.
complete : Fanion précisant si la représentation est complète ou non 0 false | 1 true.
freeadmission : Fanion précisant si la représentation est gratuite ou non 0 false | 1 true.
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).
location : Structure de l’emplacement associé à la représentation.
id : Numéro d'identification unique du lieu.
tollfree_number : Numéro sans frais.
fax : Numéro du fax.
location_map : Hyperlien de la carte de l'emplacement.
hearing_impaired: Fanion indiquant si l'emplacement a des écouteurs pour malentendants.
venue : Nom de la salle où la représentation aura lieu (français ou anglais).
sector : Nom du secteur de l'emplacement.
sector_id : Numéro d'identification du secteur.
sub_sector_id : Numéro d'identification du sous-secteur.
sub_sector : Le nom du sous-secteur où se trouve l'emplacement.
address : Sur une ligne rue, ville, province, code postal.
name : Nom de l’emplacement (français ou anglais).
seating_plan : Hyperlien du plan de la salle.
disability : Information concernant l'accès en fauteuil roulant.
longitude : Coordonnée géographique (Est-Ouest).
latitude : Coordonnée géographique (Nord-Sud).
telephone : Numéro de téléphone principal.
website : Hyperlien de l'emplacement.
artists : Liste des artistes associés à l'activité.
id : Numéro d'identification unique de l'artiste.
name : Nom de l'artiste.
itunes_link: Lien vers la page iTunes de l'artiste.
medias : Liste des médias associés à l'artiste.
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.
medias : Liste des médias associés à l'activité.
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.
coupons : Liste des coupons associés à l'activité.
title : Titre du coupon identifiant sa nature (français ou anglais).
link_pub : Lien vers le fichier coupon. Formats possibles (PDF,PNG, JPEG) (français ou anglais).
last_modication: Date de la dernière modification de l’activité.