{"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-05-29T14:25:53.068165940Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068228286Z"}},{"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-05-29T14:25:53.068237062Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068239045Z"}},{"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-05-29T14:25:53.068244105Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068246487Z"}},{"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-05-29T14:25:53.068251905Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068253760Z"}},{"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-05-29T14:25:53.068258719Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068260591Z"}},{"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-05-29T14:25:53.068266104Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068267881Z"}},{"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-05-29T14:25:53.068273131Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068274961Z"}},{"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-05-29T14:25:53.068280280Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068282500Z"}},{"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-05-29T14:25:53.068294652Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068296912Z"}},{"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-05-29T14:25:53.068302743Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068304872Z"}},{"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-05-29T14:25:53.068310072Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068311892Z"}},{"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-05-29T14:25:53.068317242Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068319137Z"}},{"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-05-29T14:25:53.068323658Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068325571Z"}},{"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-05-29T14:25:53.068336307Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068338242Z"}},{"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-05-29T14:25:53.068342532Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068344318Z"}},{"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-05-29T14:25:53.068348721Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068350508Z"}},{"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-05-29T14:25:53.068357053Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068360501Z"}},{"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-05-29T14:25:53.068379893Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068384165Z"}},{"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-05-29T14:25:53.068391332Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068394255Z"}},{"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-05-29T14:25:53.068401808Z"}},{"name":"end","in":"query","description":"Critère de date de fin - date au format ISO","schema":{"type":"string","format":"date-time","example":"2026-05-29T14:25:53.068408350Z"}},{"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"}}}}}}