La version actuelle de l'API est 2.0.
Note:
Chaque membre (M) peut exploiter ses propres données et les récupérer via un flux.
Les partenaires (P) peuvent récupérer les données du culturoscoPe et les exploiter selon des modalités et des tarifs encore à définir.
URL: https://www.culturoscope.ch/api/2.0/events.php?api_key=VOTRE_CLEF_API
(variables $_GET)
| Paramètre | Valeur | Description | Valeur par défaut | Dispo pour |
|---|---|---|---|---|
| output | json, xml, text | Format de sortie | json | M/P |
| start_date | YYYY-mm-dd | Date de début des événements | date du jour | M/P |
| end_date | YYYY-mm-dd | Date de fin des événements | M/P | |
| group_dates | 0 ou 1 | Défini si les dates des représentations sont groupées dans le tableau event_dates (1) ou si elles sont exportées comme des enregistrements distincts (0) | 1 | M/P |
| categories | EX, TH, MU, AN, DA, CI, LI, PR, PA | Catégories d'événements à exporter séparées par des virgules | Si vide, toutes les catégories sont sélectionnées | M/P |
| zones | JB, JU, BI, NE | Zones d'événements à exporter séparées par des virgules | Si vide, toutes les zones sont sélectionnées | P |
| zip | Code postal des événements à exporter | P | ||
| flags | CREATION, YOUNGPUBLIC | Labels des événements à exporter séparée par des virgules | Si vide, tous les labels sont sélectionnés | P |
| Champ | Type | Description | Dispo pour |
|---|---|---|---|
| event_id | Integer | ID de l'événement | M/P |
| event_title | Varchar | Titre de l'événement Pour les événements figurant dans l'agenda prévisonnel le titre n'est pas requis | M/P |
| event_description | Text | Description de l'événement | M/P |
| event_categories | Array | Tableau contenant les codes des catégories Vocabulaire: EX: Exposition TH: Théâtre MU: Musique AN: Animation DA: Danse CI: Cirque LI: Littérature PR: Projection PA: Patrimoine | M/P |
| event_category_label | Varchar | Texte libre pour le libellé de la catégorie | M/P |
| event_status | Varchar | Statut de publication 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 | M/P |
| event_dates | Array | Tableau contenant les objets de type «date» | M/P |
| event_flags | Array | Tableau des labels (jeune public, création, …) | M/P |
| detail_url | URL | URL complète de la page de détail de l'événement sur le site de l'organisateur·trice EX: https://www.culturoscope.ch/evt/1974 | M/P |
| image_url | URL | URL complète de l'image EX: https://www.culturoscope.ch/img/mon_image.jpg | M/P |
| image_credit | Varchar | Crédit photographique de l'image | M/P |
| booking_url | URL | URL complète de la billeterie | M/P |
| booking_phone | URL | Numéro de téléphone pour la réservation | M/P |
| booking_mail | URL | Adresse e-mail pour la réservation | M/P |
| venue_name | Varchar | Nom 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 | M/P |
| venue_address | Varchar | Adresse postale du lieu où se déroule l'événement Valeur par défaut: adresse de l'organisateur·trice | M/P |
| venue_zip | Integer | Code postal du lieu où se déroule l'événement Valeur par défaut: code postal de l'organisateur·trice | M/P |
| venue_city | Varchar | Localité du lieu où se déroule l'événement Valeur par défaut: Localité de l'organisateur·trice | M/P |
| zone | Varchar | Code de la zone où se déroule l'événement (Ex: JB, JU, BI, NE) | P |
| culturoscope_url | URL | URL complète de la page de détail de l'événement sur le culturoscoPe | M/P |
| event_categories_labels | ARRAY | Tableau contenant les intitulés des catégories du culturoscoPe | |
| event_flags_labels | ARRAY | Tableau contenant les intitulés des labels du culturoscoPe | P |