Le service ask/objects permet de récupérer une liste d'objets correspondant à une série de critères exprimés via une série de paramètres.
HubSessions est basé sur le framework Appy et est un logiciel orienté objets. Les types d'objets (ou classes) dont vous pouvez récupérer les instances via ce service sont décrites ici.
Type de requête
Requête HTTP GET
Données en entrée
Les paramètres de la requête sont les suivants.
- type (obligatoire) · Le nom de la classe dont les objets demandés sont des instances. Les types existants sont décrits ici.
- state (optionnel) · Le ou les états des objets demandés. Si plusieurs états sont listés, il faut les séparer par des virgules. Pour un point, la liste des états possibles est disponible ici (reprendre les termes utilisés dans la colonne Nom technique du premier tableau).
- committee (optionnel) · Le ou les identifiants des comités au sein desquels les objets se trouvent. Ce paramètre n'a de sens que si vous attaquez un HubSessions multi-comités. Si vous en spécifiez plusieurs, séparez-les par des virgules.
- created (optionnel) · La date de création de l'objet. Peut être une date précise (de la forme YYYMMDD) ou un intervalle de dates (de la forme YYYMMDD,YYYMMDD).
- modified (optionnel) · La date de dernière modification de l'objet. Peut être une date précise (de la forme YYYMMDD) ou un intervalle de dates (de la forme YYYMMDD,YYYMMDD).
- itemDate (optionnel) · Valable uniquement si le type d'objets est Item, ce paramètre vous permet de spécifier un jour précis (de la forme YYYMMDD) ou un intervalle de dates (de la forme YYYMMDD,YYYMMDD). La recherche se limitera aux points dont la date est incluse dans l'unique jour spécifié ou dans l'intervalle. La sémantique de cette date est la suivante. Tant que le point n’est pas inséré dans une séance, cette date est celle de la dernière action perpétrée sur le point : date de création, date de proposition, date de validation, etc. Dès qu’un point est inséré dans une séance, cette date devient la date de la séance.
- sortBy (optionnel) · Permet de trier la liste des objets retournés. La clé par défaut est title (le titre de l'objet). D'autres clés de tri peuvent être utilisées, dont les 3 paramètres précédents: state, committe ou itemDate.
Exemple de requête
La requête suivante récupère tous les points pré-acceptés et acceptés en septembre 2025.
<siteUrl>/ask/objects?type=Item&state=accepted,confirmed&itemDate=20250901,20250930&sortBy=itemDate
Données de retour
Le service retourne une liste de données minimales au sujet de chaque point correspondant aux critères de recherche: son identifiant, son titre et son URL.
Voici un exemple: il devrait contenir 289 résultats mais est tronqué à 3.
<objects type="list" count="289">
<e type="object" className="Object">
<id type="int">918</id>
<title>Obligation légale d'affichage du nutriscore.</title>
<url><siteUrl>/918/xml</url>
</e>
<e type="object" className="Object">
<id type="int">1772</id>
<title>Séance conjointe du Gouvernement wallon et du Gouvernement de la Communauté française.</title>
<url><siteUrl>/1772/xml</url>
</e>
<e type="object" className="Object">
<id type="int">1459</id>
<title>Désignation de Madame Elisabeth Degryse en qualité de Ministre-Présidente du Gouvernement de la Communauté française.</title>
<url><siteUrl>/1459/xml</url>
</e>
...
</objects>
Une requête GET additionnelle sur l'URL d'un objet de la liste vous mènera à sa page de détail, correspondant à un service additionnel (récupération d'informations détaillées au sujet d'un point, d'une séance, d'une annexe, etc.
Présence de sites d'archives
Ce service se cantonne au site appelé. Si vous souhaitez faire des requêtes sur des sites d'archives, vous devez les attaquer en direct.