Chaque événement enregistré présente un champ audience_id qui fournit une information sur le type de public visé par cet événement. Cette information permet de cibler des publics spécifiques et apporter une information complémentaire au visiteur.

Chacun de ces « types de public » (tout public, public adulte, jeune public, etc.) se distingue par un identifiant unique (numérique), et un libellé.


Les types de public utilisées dans l'API Amienscope ne sont pas fixes. La collectivité a la possibilité d'ajouter, modifier et supprimer des types de public.
GET https://api.amienscope.fr/get/audiences

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 types de public utilisés dans l'API (qu'ils soient ou non liés à des événements visibles) :

[
	{
		"id":"1",
		"label":"Tout public",
		"event_count":"113"
	},
	{
		"id":"2",
		"label":"Jeune public",
		"event_count":"7"
	},
	{
		"id":"3",
		"label":"\u00c0 partir de 12 ans",
		"event_count":"0"
	}
	...
]
Champ Type Description
id int Identifiant unique de type de public
label str Nom/Libellé de ce type de public
event_count int Nombre d'événements actuellement publiés correspondants à ce type de public

L'identifiant unique d'un type de public peut être utilisé pour effectuer une requête de recherche d'événements sur des critères multiples.

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