1. Amienscope API
2. Manipulation d'événements

Une fois que vous disposez de l'identifiant unique d'une forme d'accessibilité (dont la liste s'obtient à l'aide de la requête sur les formes d'accessibilité disponibles), vous avez la possibilité de remonter une liste d'événements correspondant à une forme d'accessibilité donnée.

Nous verrons plus bas dans cette page qu'il est également possible de demander des listes paginées à l'aide de paramètres supplémentaires passés à l'URL.

Par exemple, si l'on souhaite les événements proposant une interprétation gestuelle (pour les personnes malentendantes), si l'on admet que l'identifiant unique de cette forme d'accessibilité est 4, nous aurons la requête suivante :

https://api.amienscope.fr/get/from_accessibility/4

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.

GET https://api.amienscope.fr/get/from_accessibility/<accessibility_id>/<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 de la forme d'accessibilité ID 1, à partir du 20ème élément, la requête effectuée sera la suivante :

https://api.amienscope.fr/get/from_accessibility/1/20,10

/get/categories

Catégories d'événements utilisées dans l'API

/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

/get/audiences

Liste des publics visés utilisés par les événements

/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