Événements à la Une

Les événements à la Une sont des événement selectionnés par la collectivité d'Amiens Métropole pour leur mise en avant particulière. C'est une sélection d'événements parmi tous ceux présents dans les catégories.

Tous les événements placés « à la Une » peuvent être également retrouvés dans les listings de leurs catégories correspondantes.

GET https://api.amienscope.fr/get/highlights

Cette requête effectue une requête classique de listing d'événements, par conséquent les champs retournés sont les mêmes que dans un listing catégoriel. Voir le détail sur la page Liste d'événements d'une catégorie.

Par défaut, en l'absence de paramètres de pagination, les listings sont limités à 20 événements à partir du premier.

Dans le cadre d'une navigation par pagination, il vous est possible d'ajouter des paramètres offet et limit à l'URL de la requête afin d'obtenir des listings paginés.

Les listings sont limités à 50 éléments au maximum afin de limiter l'utilisation des ressources serveur. Toute requête demandant un listing supérieur à 50 éléments sera automatiquement limitée.

GET https://api.amienscope.fr/get/highlights/<offset>,<limit>

Les paramètres offset et limit doivent être des entiers, et obligatoirement passés à l'URL sous le format « offset,limit ».

Par exemple, pour obtenir une liste de 10 événements placés « à la Une », à partir du 20ème élément, la requête effectuée sera la suivante :

https://api.amienscope.fr/get/highlights/20,10

/get/categories: Catégories d'événements utilisées dans l'API
/get/audiences: Liste des publics visés utilisés par les événements
/get/organisers: Organisateurs d'événements connus de 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/updates/<time>: Événements mis à jour ou modifiés depuis une date donnée
/get/event/<id>: Détail des informations complètes d'un événement spécifique
/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é

Requête sur l'API

Valeurs de retour

Pagination et limitation du listing : offset et limit

Requête sur l'API

Voir aussi