Organisateurs d'événements
Les événements issus de l'API Amienscope peuvent être manipulés en fonction de leur catégorie, mais il est également possible de les manipuler en fonction de leur organisateur.
Afin d'obtenir des listings d'événements via la liste des événements d'un organisateur, il est nécessaire de lister tous les organisateurs connus, afin d'obtenir leurs identifiants uniques correspondants.
Les organisateurs utilisées dans l'API Amienscope, tout comme les catégories d'événements, ne sont pas fixes.
La collectivité ayant la possibilité d'ajouter, modifier et supprimer des organisateurs d'événements, il est préférable de faire
cette requête de récupération des organisateurs avant d'effectuer requête de listing d'événements.
Requête sur l'API
https://api.amienscope.fr/get/organisers
Valeurs de retour
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 (de type tableau) contenant tous les organisateurs connus dans l'API :
[
{
"id":"13",
"name":"Cirque Jules Verne",
"phone":"03 60 01 02 41",
"email":"",
"website":"",
"organiser_categories":[
{
"organiser_category_id":"6",
"organiser_category_name":"Salles de Spectacle"
}
],
"address_location":"Cirque Jules Verne",
"address_number":"",
"address_street_addr":"Place Longueville",
"address_addr_info":"",
"address_latitude":"49.888256",
"address_longitude":"2.296097",
"city_id":"32505",
"city_name":"Amiens",
"city_postal_code":"80000",
"state_code":"80",
"state_name":"Somme"
},
{
"id":"11",
"name":"Nuits d'Artistes",
"phone":"",
"email":"",
"website":"",
"organiser_categories":[
{
"organiser_category_id":"9",
"organiser_category_name":"Producteurs"
}
],
"address_location":"Nuits d'Artistes",
"address_number":"",
"address_street_addr":"",
"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"
},
{
"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"
},
...
]
Détail des champs retournés
| Champ | Type | Description | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
id |
int | Identifiant unique de l'organisateur | |||||||||
name |
str | Nom de l'organisateur / structure | |||||||||
phone |
str | Numéro de téléphone | |||||||||
email |
str | Adresse e-mail | |||||||||
website |
str | Adresse URL de site Internet | |||||||||
organiser_categories |
array |
Tableau d'objets contenant la ou les catégories d'organisateurs auxquelles l'organisateur est attaché (à ne pas confondre avec les catégories d'événements !). Chaque élément du tableau est composé des champs suivants :
|
|||||||||
address_location |
str | Nom du lieu/structure | |||||||||
address_number |
str | Numéro de rue | |||||||||
address_street_addr |
str | Nom de rue/voie | |||||||||
address_addr_info |
str | Complément d'adresse | |||||||||
address_latitude |
float | Latitude (GPS) de cette adresse | |||||||||
address_longitude |
float | Longitude (GPS) de cette adresse | |||||||||
city_id |
int | Identifiant unique de la ville | |||||||||
city_name |
str | Nom de la ville | |||||||||
city_postal_code |
str | Code postal de la ville | |||||||||
state_code |
str | Numéro de département | |||||||||
state_name |
str | Nom du département |
L'identifiant unique d'un organisateur peut à présent être utilisé pour effectuer une requête de listing d'événements sur un organisateur donné.
Voir aussi
- /get/categories
- Catégories d'événements utilisées dans 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/event/<id>
- Détail des informations complètes d'un événement spécifique
- /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é