Documentation de l’API
L’API REST du back-office, décrite au format OpenAPI 3.1 : ce qu’un partenaire, une application mobile ou un autre site peut lire.
L’API REST du back-office Payload, en lecture : chaque collection publiée est exposée sans authentification, dans le format de Payload (docs, totalDocs, page, totalPages…). L’écriture demande une session ou une clé d’API ; les contenus en brouillon ne sortent jamais sans session. Les fichiers (images, PDF) sont servis sous /api/<collection>/file/<nom>.
Adresse de base : https://demo.rhanb.com/api Télécharger le document OpenAPI (JSON) · Licence Ouverte 2.0 (données fictives de démonstration)
Exemple :
curl "https://demo.rhanb.com/api/actualites?limit=3&sort=-datePublication&depth=0"- GET
/pagespagesLister : Pages
Les pages éditoriales, avec leur arborescence et leurs blocs.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/pages/{id}pagesLire : Page
Paramètres Nom Type Description id integer - GET
/actualitesactualitesLister : Actualités
Les actualités publiées.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/actualites/{id}actualitesLire : Actualité
Paramètres Nom Type Description id integer - GET
/agendaagendaLister : Agenda
Les événements de l’agenda.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/agenda/{id}agendaLire : Événement
Paramètres Nom Type Description id integer - GET
/servicesservicesLister : Services
Les services municipaux de l’annuaire.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/services/{id}servicesLire : Service municipal
Paramètres Nom Type Description id integer - GET
/eluselusLister : Élus
Les élus du conseil municipal.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/elus/{id}elusLire : Élu
Paramètres Nom Type Description id integer - GET
/equipementsequipementsLister : Équipements
Les équipements de la commune, avec leur position sur le plan.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/equipements/{id}equipementsLire : Équipement
Paramètres Nom Type Description id integer - GET
/demarchesdemarchesLister : Démarches
Les démarches et leur marche à suivre.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/demarches/{id}demarchesLire : Démarche
Paramètres Nom Type Description id integer - GET
/documentsdocumentsLister : Documents et actes
Les actes et publications ; les documents restreints n’apparaissent pas sans session.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/documents/{id}documentsLire : Document
Paramètres Nom Type Description id integer - GET
/themesthemesLister : Thèmes
La taxonomie commune.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/themes/{id}themesLire : Thème
Paramètres Nom Type Description id integer - GET
/sitessitesLister : Sites et mini-sites
Le site principal et les mini-sites.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/sites/{id}sitesLire : Site
Paramètres Nom Type Description id integer - GET
/mediasmediasLister : Médiathèque
La médiathèque : métadonnées et déclinaisons d’image.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/medias/{id}mediasLire : Média
Paramètres Nom Type Description id integer - GET
/redirectionsredirectionsLister : Redirections
Les redirections actives.
Paramètres Nom Type Description limit integer Nombre de documents par page. page integer sort string Champ de tri ; précédé de - pour l’ordre décroissant (ex. -datePublication). where object Filtre, syntaxe where[champ][operateur]=valeur ; opérateurs : equals, contains, in, greater_than, less_than… depth integer Profondeur de résolution des relations. locale fr | en Langue des champs localisés. - GET
/redirections/{id}redirectionsLire : Redirection
Paramètres Nom Type Description id integer - GET
/openapi.jsonmetaCette description
- GET
/santemetaLa sonde de santé du back-office