{"openapi":"3.1.0","info":{"title":"API Géoplateforme - Statistiques d'utilisation","description":"Ce service permet d'obtenir des statistiques d'utilisation des services.","termsOfService":"https://cartes.gouv.fr/cgu","contact":{"name":"Geoplateforme","url":"https://cartes.gouv.fr","email":"geoplateforme@ign.fr"},"version":"1.0.0"},"servers":[{"url":"https://data.geopf.fr/api"}],"security":[{"Keycloak-Authentication":[]}],"tags":[{"name":"Administrateur","description":"Statistiques admins sur le trafic des géoservices"},{"name":"Organisations","description":"Statistiques d'organisation sur le trafic des géoservices"},{"name":"Communautés","description":"Statistiques de communautés sur le trafic des géoservices"},{"name":"Entrepôts","description":"Statistiques d'entrepôts sur le trafic des géoservices"},{"name":"Utilisateurs","description":"Statistiques de l'utilisateur sur le trafic des géoservices"}],"paths":{"/users/me/stats":{"get":{"tags":["Utilisateurs"],"summary":"Statistiques d'un utilisateur","description":"Retourne la consommation de l’utilisateur authentifié entre deux dates","operationId":"stats","parameters":[{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306263834Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306364039Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/users/me/permissions/{permission}/stats":{"get":{"tags":["Utilisateurs"],"summary":"Statistiques d'une permission utilisateur","description":"Renvoie la liste des statistiques pour la période donnée concernant l'utilisation de la permission utilisateur","operationId":"permissionStats","parameters":[{"name":"permission","in":"path","description":"Identifiant de la permission utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306380241Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306383474Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Permission inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/users/me/keys/{key}/stats":{"get":{"tags":["Utilisateurs"],"summary":"Statistiques d'une clé utilisateur","description":"Renvoie la liste des statistiques pour la période donnée concernant l'utilisation de la clé utilisateur","operationId":"keyStats","parameters":[{"name":"key","in":"path","description":"Identifiant de la clé utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306389686Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306392121Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Clé utilisateur inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/users/me/keys/{key}/accesses/{access}/stats":{"get":{"tags":["Utilisateurs"],"summary":"Statistiques d'un accès utilisateur","description":"Renvoie la liste des statistiques pour la période donnée concernant l'utilisation de l'accès utilisateur lié à une clé utilisateur","operationId":"accessStats","parameters":[{"name":"access","in":"path","description":"Identifiant de l'accès utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"key","in":"path","description":"Identifiant de la clé utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306398654Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306404495Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Accès utilisateur inconnu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/organizations/{organization}/stats":{"get":{"tags":["Organisations"],"summary":"Statistiques d'une organisation","description":"Retourne la consommation d'une organisation entre deux dates","operationId":"stats_1","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation' utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306411404Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306426866Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Organisation inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/organizations/{organization}/permissions/{permission}/stats":{"get":{"tags":["Organisations"],"summary":"Statistiques d'une permission d'une organisation","description":"Retourne la consommation d'une permission d'une organisation entre deux dates","operationId":"permisionStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"permission","in":"path","description":"Identifiant de la permission demandée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306432960Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306436940Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Organisation inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/organizations/{organization}/offerings/{offering}/stats":{"get":{"tags":["Organisations"],"summary":"Statistiques d'une offre d'une organisation","description":"Retourne la consommation d'une offre d'une organisation entre deux dates","operationId":"offeringStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation' utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"offering","in":"path","description":"Identifiant de l'offre' utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306443265Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306445502Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Organisation inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/organizations/{organization}/endpoints/{endpoint}/stats":{"get":{"tags":["Organisations"],"summary":"Statistiques d'un endpoint d'une organisation","description":"Retourne la consommation d'un endpoint entre deux dates","operationId":"EndpointStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","description":"Identifiant de l'endpoint utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306451221Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306453636Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Point d'accès inconnu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/organizations/{organization}/communities/{community}/stats":{"get":{"tags":["Organisations"],"summary":"Statistiques d'une communauté d'une organisation","description":"Retourne la consommation d'une communauté d'une organisation entre deux dates","operationId":"communityStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"community","in":"path","description":"Identifiant de la communauté utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306459336Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306461541Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Organisation inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/datastores/{datastore}/permissions/{permission}/stats":{"get":{"tags":["Entrepôts"],"summary":"Statistiques d'un entrepôt","description":"Retourne la consommation sur une permission d'un entrepôt entre deux dates","operationId":"permissionStats_1","parameters":[{"name":"datastore","in":"path","description":"Identifiant du datastore utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"permission","in":"path","description":"Identifiant de la permission utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306477789Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306480080Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Permission inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/datastores/{datastore}/offerings/{offering}/stats":{"get":{"tags":["Entrepôts"],"summary":"Statistiques d'un entrepôt","description":"Retourne la consommation sur une offre d'un entrepôt entre deux dates","operationId":"offeringStats_1","parameters":[{"name":"datastore","in":"path","description":"Identifiant du datastore utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"offering","in":"path","description":"Identifiant de l'offering utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306485937Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306488497Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Offre inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/datastores/{datastore}/endpoints/{endpoint}/stats":{"get":{"tags":["Entrepôts"],"summary":"Statistiques d'un entrepôt","description":"Retourne la consommation sur un endpoint d'un entrepôt entre deux dates","operationId":"endpointStats","parameters":[{"name":"datastore","in":"path","description":"Identifiant de l'entrepôt utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","description":"Identifiant de l'endpoint utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306492427Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306493922Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Point d'accès inconnu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/communities/{community}/stats":{"get":{"tags":["Communautés"],"summary":"Statistiques d'une communauté","description":"Retourne la consommation d'une communauté entre deux dates","operationId":"stats_2","parameters":[{"name":"community","in":"path","description":"Identifiant de la communauté utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306497197Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306498512Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Communauté inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/communities/{community}/permissions/{permission}/stats":{"get":{"tags":["Communautés"],"summary":"Statistiques d'une permission d'une communauté","description":"Retourne la consommation d'une permission d'une communauté entre deux dates","operationId":"permissionStats_2","parameters":[{"name":"permission","in":"path","description":"Identifiant de la permission utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"community","in":"path","description":"Identifiant de la communauté utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306503855Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306505432Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Permission inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/permissions/{permission}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'une permission","description":"Retourne la consommation d'une permission entre deux dates","operationId":"permissionStats_3","parameters":[{"name":"permission","in":"path","description":"Identifiant de la permission","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306508655Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306510127Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Permission inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/organizations/{organization}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'une organisation","description":"Retourne la consommation d'une organisation entre deux dates","operationId":"organizationStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306513352Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306514747Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Organisation inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/organizations/{organization}/endpoints/{endpoint}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'un endpoint d'une organisation","description":"Retourne la consommation d'un endpoint entre deux dates","operationId":"organizationEndpointStats","parameters":[{"name":"organization","in":"path","description":"Identifiant de l'organisation utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"endpoint","in":"path","description":"Identifiant de l'endpoint utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306519517Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306521867Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Point d'accès inconnu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/offerings/{offering}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'une offre","description":"Retourne la consommation sur une offre entre deux dates","operationId":"offeringStats_2","parameters":[{"name":"offering","in":"path","description":"Identifiant de l'offering utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306528297Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306530507Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Offre inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/endpoints/{endpoint}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'un endpoint","description":"Retourne la consommation d'un endpoint entre deux dates","operationId":"endpointStats_1","parameters":[{"name":"endpoint","in":"path","description":"Identifiant de l'endpoint utilisé","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306535589Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306537895Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Point d'accès inconnu","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}},"/administrator/communities/{community}/stats":{"get":{"tags":["Administrateur"],"summary":"Statistiques d'une communauté","description":"Retourne la consommation d'une communauté entre deux dates","operationId":"communityStats_1","parameters":[{"name":"community","in":"path","description":"Identifiant de la communauté utilisée","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"start","in":"query","description":"Critère de date de début - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306542645Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-08-14T15:35:36.306544804Z"}},{"name":"details","in":"query","description":"Ajouter les détails avec une aggrégation plus fine","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","description":"Réponse paginée avec le numéro de page","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","description":"Réponse paginée avec le nombre de détails par page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Liste des statistiques","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}},"404":{"description":"Communauté inconnue","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HitStatisticsDto"}}}}}}}},"components":{"schemas":{"HitStatisticsDto":{"properties":{"total":{"$ref":"#/components/schemas/HitsDto"},"details":{"type":"array","items":{"$ref":"#/components/schemas/HitsDto"}}}},"HitsDto":{"properties":{"begin_date":{"type":"string","format":"date-time"},"end_date":{"type":"string","format":"date-time"},"data_transfer":{"type":"integer","format":"int64"},"hits":{"type":"integer","format":"int64"}}}},"securitySchemes":{"Keycloak-Authentication":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://sso.geopf.fr/realms/geoplateforme/protocol/openid-connect/auth","tokenUrl":"https://sso.geopf.fr/realms/geoplateforme/protocol/openid-connect/token"}}}}}}