Le tri par date d’ouverture est disponible pour les services et les limitations de types suivantes :
- sur /api/v002/recherche/ pour les FETE_ET_MANIFESTATION et ACTIVITE
- sur /api/v002/agenda/simple pour les FETE_ET_MANIFESTATION et ACTIVITE
- sur /api/v002/agenda/detaille pour les FETE_ET_MANIFESTATION et ACTIVITE
Il s’utilise en précisant le champ "order":"DATE_OUVERTURE" dans les attributs de la requête.
Pour l’agenda simple, le tri par date d’ouverture est le tri par défaut.
Exemple :
{
"apiKey": "test",
"projetId": 132,
"selectionIds": [12346, 12347],
"order":"DATE_OUVERTURE"
}Le tri par date d’ouverture peut prendre en compte une date de début et une date de fin, au format YYYY-MM-DD :
- La date de début est obligatoire, et positionnée par défaut à la date du jour. Il est possible de la surcharger pour chercher sur des périodes plus lointaines,
- La date de fin est optionnelle
Exemple :
{
"apiKey": "test",
"projetId": 132,
...
"order":"DATE_OUVERTURE"
"dateDebut":"2025-08-15"
"dateFin":"2025-11-25"
}La recherche ciblera ici toutes les FETE_ET_MANIFESTATION et ACTIVITE ouvertes entre le 15/08/2025 et le 25/11/2025, et les triera selon les règles décrites ci-dessous.
Description de l’algorithme de tri par date.
Pour une requête de recherche, les éléments sont triés :
- par la première date d’ouverture suivant la date de début indiquée (par rapport à la date indiquée, si A ouvre pour la première fois le lendemain, et B le surlendemain, alors A arrive avant B)
- par la date de fin de la période d’ouverture : les objets qui ouvrent pour la première fois le même jour sont triés de manière à mettre en avant ceux qui ferment le plus vite. Les objets ouvert une journée sont listés avant ceux qui resteront ouverts plusieurs jours
- par l’horaire d’ouverture : en particulier pour les objets qui ouvrent un seul jour (donc en début de classement), les objets qui ouvrent tôt sont classés avant les objets qui ouvrent tard.
- Les objets sans horaire d’ouverture sont positionnés à la fin.
Pour une requête agenda, les objets sont déjà triés par date (une occurence par jour d’ouverture). Au sein d’une journée, les tris par date de fin de la période d’ouverture puis par horaire d’ouverture sont réalisés.