Nouveaux événements

Les nouveaux événements sont les événements qui ont été ajoutés le plus récemment à la base de données de l'API.

Attention : ce ne sont pas les événements qui auront lieu le plus récemment. Simplement les derniers ajouts dans la base de données d'événements. Ils peuvent donc très bien avoir lieu dans un futur plus lointain. Si vous souhaitez remonter les événements qui auront lieu le plus récemment, préférez la requête sur les prochains événements à venir.

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

Cette requête effectue une requête classique de listing d'une catégorie, 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/recent/<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 les plus récemment ajoutés, à partir du 20ème élément, la requête effectuée sera la suivante :

https://api.amienscope.fr/get/recent/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/highlights: Événements mis en avant par la collectivité (ou « À la Une »)
/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