Champs du flux

Structure de base du flux JSON

{
 "api_key": "123456",
    "events": [
        {
            ...
            "event_dates": [{ date, date, … }],
            
        },
        {
            ...
            "event_dates": [{ date, date, … }],
            
        },
        …
}


Exemple de flux JSON (26 Ko)

feed

ChampTypeDescription
api_keyVarcharClef de l'API REQUIS
eventsArrayTableau contenant les objets de type «event»

event

ChampTypeDescription
event_idIntegerID de l'événement REQUIS
event_titleVarcharTitre de l'événement REQUIS

Pour les événements figurant dans l'agenda prévisonnel le titre n'est pas requis
event_descriptionTextDescription de l'événement
event_categoriesArrayTableau contenant les codes des catégories REQUIS

Vocabulaire:
AN: Animation
CI: Cirque
DA: Danse
EX: Exposition
LI: Littérature
MU: Musique
PA: Patrimoine
PR: Projection
TH: Théâtre
event_category_labelVarcharTexte libre pour le libellé de la catégorie
event_statusVarcharStatut de publication REQUIS

Valeurs possibles:
PUBLIC: Publié dans le culturoscoPe et dans l'agenda prévisionnel
PRIVATE: Publié uniquement dans l'agenda prévisionnel dont l'accès est réservé aux organisateurs·trices

Valeur par défaut: PUBLIC
event_datesArrayTableau contenant les objets de type «date» REQUIS
event_flagsArrayTableau des labels (jeune public, création, …)
detail_urlURLURL complète de la page de détail de l'événement sur le site de l'organisateur·trice REQUIS

EX: https://www.culturoscope.ch/evt/1974
image_urlURLURL complète de l'image REQUIS

EX: https://www.culturoscope.ch/img/mon_image.jpg
image_creditVarcharCrédit photographique de l'image
booking_urlURLURL complète de la billeterie
booking_phoneURLNuméro de téléphone pour la réservation
booking_mailURLAdresse e-mail pour la réservation
venue_nameVarcharNom du lieu où se déroule l'événement

Valeur par défaut: nom du lieu de l'organisateur·trice défini dans son profil culturoscoPe
venue_addressVarcharAdresse postale du lieu où se déroule l'événement

Valeur par défaut: adresse de l'organisateur·trice
venue_zipIntegerCode postal du lieu où se déroule l'événement

Valeur par défaut: code postal de l'organisateur·trice
venue_cityVarcharLocalité du lieu où se déroule l'événement

Valeur par défaut: Localité de l'organisateur·trice

date

ChampTypeDescription
start_dateDatetimeDate et heure de début de l'événementREQUIS
end_dateDatetimeDate et heure de fin de l'événement
date_statusVarcharStatut de l'événement pour la date

Vocabulaire:
SOLDOUT: Complet
CANCELLED: Annulé
RESCHEDULDED: Reporté
Valeur par défaut: -vide-


Note:

  • les événements de catégorie EX requièrent une date de début et de fin (l'heure n'est pas prise en compte). Les événements des autres catégories doivent avoir au moins une date et une heure de début (start_date, end_date).
  • Il est possible d'attribuer plusieurs catégories à un événement, sauf dans le cas d'une exposition.

Les informations ci-dessus sont générées dynamiquement et représentent l'état actuel du culturoscoPe (version 2.0).