Statistiques
Cette section regroupe l’ensemble des indicateurs permettant à un utilisateur de suivre l’activité de ses signalements sur la plateforme.
Elle fournit une vue globale et synthétique de l’ensemble des demandes effectuées, de leur état d’avancement, ainsi que des actions associées tout au long du processus de traitement.
Les statistiques permettent notamment de :
- suivre le nombre total de signalements effectués
- visualiser la répartition des signalements selon leur statut
- identifier les signalements en attente, en cours de traitement ou finalisés
- consulter la répartition des signalements par type
- suivre les tâches en attente liées aux signalements (évaluation, confirmation)
Ces données sont calculées en temps réel à partir des informations liées à l’utilisateur connecté.
Statistiques utilisateur
Cette API permet à un utilisateur connecté de consulter ses statistiques personnelles liées à ses signalements.
Elle offre une vue globale sur :
- les signalements effectués par l’utilisateur
- leur état d’avancement
- les différents types de signalements réalisés
- les tâches en attente associées aux signalements
Endpoint : GET /statistics
Authentification : Bearer Token
Headers requis
Authorization: Bearer <access_token>
Content-Type: application/json
Accept: application/json
Données retournées
- Statistiques globales
- total des signalements de l’utilisateur
- répartition par statut
- Statuts des signalements
| Code | Description |
|---|---|
pending | en attente |
rejected | rejetés |
received | reçus |
in_processing | en traitement |
approved | approuvés |
terminated | terminés |
- Types de signalement pris en compte :
| Code | Description |
|---|---|
zob | Zone Blanche |
cpo | Absence d'Opérateur(s) |
cps | Mauvais Signal d'Opérateur(s) |
abi | Absence d'Internet |
- Tâches utilisateur
| Code | Description |
|---|---|
evaluation_tasks | signalements à évaluer |
confirmation_tasks | confirmations en attente |
Requête :
curl -X GET "https://clients-api-services.mazone-test.ansut.ci/api/v1.0/statistics" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json"
Réponse succès (200) :
{
"error": false,
"message": "Successfully",
"data": {
"total_requests": 120,
"pending": 20,
"rejected": 10,
"received": 15,
"in_processing": 25,
"approved": 30,
"terminated": 20,
"percent_pending": 16.66,
"percent_rejected": 8.33,
"percent_approved": 25.0,
"percent_terminated": 16.66,
"zob": 40,
"cpo": 30,
"cps": 25,
"abi": 25,
"evaluation_tasks": 5,
"confirmation_tasks": 3,
"last_refresh_at": "2026-05-11 16:10:00"
}
}
Comportement métier
Lors de la récupération :
- filtrage automatique par utilisateur connecté
- calcul des statistiques uniquement sur ses demandes
- agrégation des statuts des signalements
- regroupement par type de signalement
- calcul des tâches en attente
- retour de la date de dernière mise à jour
Statistiques signalements
Cette API permet de consulter les statistiques globales des signalements traités sur la plateforme.
Elle fournit une vue synthétique de la répartition des signalements par type, ainsi que le nombre de signalements finalisés pour chaque catégorie.
Ces statistiques permettent d’analyser l’évolution globale des incidents signalés et leur niveau de traitement.
Endpoint : GET /by-type-statistics'
Authentification : Aucun
Headers requis
Content-Type: application/json
Accept: application/json
Données retournées
- Types de signalement pris en compte :
| Code | Description |
|---|---|
zob | Zone Blanche |
cpo | Absence d'Opérateur(s) |
cps | Mauvais Signal d'Opérateur(s) |
abi | Absence d'Internet |
- Signalements finalisés par type
| Code | Description |
|---|---|
total_zob_terminated | signalements ZOB terminés |
total_cpo_terminated | signalements CPO terminés |
total_cps_terminated | signalements CPS terminés |
total_abi_terminated | signalements ABI terminés |
Requête :
curl -X GET "https://clients-api-services.mazone-test.ansut.ci/api/v1.0/by-type-statistics'" \
-H "Content-Type: application/json"
Réponse succès (200) :
{
"error": false,
"message": "Successfully",
"data": {
"zob": 120,
"cpo": 80,
"cps": 65,
"abi": 40,
"total_zob_terminated": 50,
"total_cpo_terminated": 30,
"total_cps_terminated": 25,
"total_abi_terminated": 10,
"last_refresh_at": "2026-05-11 16:20:00"
}
}
Comportement métier
Lors de la récupération :
- filtrage des signalements selon leur statut actif (APPROVED, CONFIRMED, TERMINATED, IN_PROGRESS)
- agrégation des signalements par type
- calcul des signalements terminés par type
- exclusion des signalements non finalisés
- retour de la dernière date de mise à jour des données