Service :: Liste des activités
L’URL ci-dessous permet de récupérer la liste complète des activités actuellement publiées sur le site. Une activité publiée n’est pas nécessairement (encore) ouverte pour inscription.
{siteUrl}/get/activities
Voici un exemple de réponse. Elle est tronquée à 2 éléments sur un total de 6.
<activities type="list" count="6">
<e type="object" className="Object">
<title>Tennis passion</title>
<url>http://{siteUrl}/52897/xml</url>
<activityType>normal</activityType>
</e>
<e type="object" className="Object">
<title>Tout le monde à la mer</title>
<url>http://{siteUrl}/15827/xml</url>
<activityType>trip</activityType>
</e>
...
</activities>
3 informations sont présentes dans la liste pour chaque activité :
- son nom (tag title) ;
- son URL (tag url), permettant, via une requête HTTP GET additionnelle, de récupérer l’entièreté de la description de l’activité (voir la section suivante) ;
- son type (tag activityType), pouvant valoir une des valeurs listées dans le tableau ci-dessous.
En outre, l’identifiant de chaque activité est présent dans son URL. La première activité, par exemple, a l’identifiant 52897. Ce type d’identifiant vous permet notamment :
- de savoir si vous avez déjà récupéré les données concernant cette activité ;
- de lancer une synchronisation de données sur une activité précise, car son URL peut se reconstruire facilement sur base de cet identifiant.
| Valeur |
Type d'activité |
normal |
Stages pour enfants |
normal2 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
trip |
Excursions pour enfants, avec ou sans leurs parents |
trip2 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
after |
Activités parascolaires pour enfants |
after2 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
after3 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
camp |
Colonies de vacances pour enfants |
aid |
Aides à l'édude pour enfants, ados et jeunes adultes |
schooltime |
Activités organisées durant le temps scolaire, à l'exception des garderies et repas chauds |
event |
Événements avec achat de tickets non nominatifs, pour tout public |
event2 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
event3 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
event4 |
Idem, avec configuration différente potentielle ou gestion par un domaine distinct |
workshop |
Activités nominatives pour adultes |
daycare |
Garderies scolaires, organisées par des écoles le matin, le soir et le mercredi après-midi |
meal |
Repas chauds durant le temps de midi dans les écoles |
Un sous-ensemble seulement de ces types est probablement activé sur chaque site rEve. Un service spécifique vous permet de récupérer la liste des types d'activiés utilisés.
Paramètre type
L’URL peut accepter un paramètre permettant de ne récupérer que les activités d’un type donné. Par exemple, appeler :
{siteUrl}/get/activities?type=trip
produira la même liste que précédemment, mais contenant uniquement les activités de type trip.
Il est possible de spécifier plusieurs types, séparés par des virgules. Dans ce cas, le résultat contiendra les activités de tous ces types (il s’agit d’un « or » logique). Voici un exemple :
{siteUrl}/get/activities?type=normal,trip
Paramètre domainCategory
Un second paramètre peut également être spécifié et n'a de sens que sur un site rEve multi-domaines, c'est-à-dire dont les activités sont gérées par plusieurs entités (par exemple, plusieurs services communaux et/ou asbl paracommunales).
Il permet de ne récupérer que les activités issues de domaines étant associés à une catégorie définie.
Voici un exemple:
{siteUrl}/get/activities?domainCategory=website
À l'instar du paramètre type, le paramètre domainCategory peut accepter plusieurs identifiants de catégories de domaines, séparés par des virgules.
Vous pouvez consulter la liste des catégories de domaine actives via ce service spécifique.
Combiner tous les paramètres
Il est bien entendu possible de combiner tous les paramètres, comme sur cet exemple.
{siteUrl}/get/activities&type=normal,trip&domainCategory=website
