Prochains événements à venir

Les prochains événements à venir sont les événements dont leur date de représentation est la plus proche. Ce listing se fait sans distinction de catégorie ; il s'agit donc tout simplement des événements qui auront lieu dans le futur le plus proche, ordonnés par date de représentation croissante.

Attention : ce ne sont pas les événements qui ont été ajoutés le plus récemment dans la base de données. Si vous souhaitez remonter les derniers ajouts dans la base de données d'événements (sans distinction de date de représentation), préférez la requête sur les nouveaux événements ajoutés.

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

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/next/<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/next/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/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
/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