Pierre
232940b1eb
- #17: Amélioration gestion des secteurs et statistiques - #18: Optimisation services API et logs - #19: Corrections Flutter widgets et repositories - #20: Fix création passage - détection automatique ope_users.id vs users.id Suppression dossier web/ (migration vers app Flutter) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
217 lines
5.2 KiB
Markdown
217 lines
5.2 KiB
Markdown
API Event Stats - Guide Flutter
|
|
|
|
Authentification
|
|
|
|
Toutes les routes nécessitent un Bearer Token (session) et un rôle Admin (2) ou Super-admin (1).
|
|
|
|
headers: {
|
|
'Authorization': 'Bearer $sessionToken',
|
|
'Content-Type': 'application/json',
|
|
}
|
|
|
|
---
|
|
|
|
1. Résumé du jour
|
|
|
|
GET /api/events/stats/summary?date=2025-12-22
|
|
|
|
| Param | Type | Requis | Description |
|
|
| ----- | ------ | ------ | ------------------------------------- |
|
|
| date | string | Non | Date YYYY-MM-DD (défaut: aujourd'hui) |
|
|
|
|
Réponse (~1 KB) :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"date": "2025-12-22",
|
|
"stats": {
|
|
"auth": { "success": 45, "failed": 3, "logout": 12 },
|
|
"passages": { "created": 128, "updated": 5, "deleted": 2, "amount": 2450.00 },
|
|
"users": { "created": 2, "updated": 5, "deleted": 0 },
|
|
"sectors": { "created": 1, "updated": 3, "deleted": 0 },
|
|
"stripe": { "created": 15, "success": 12, "failed": 1, "cancelled": 2, "amount": 890.00 }
|
|
},
|
|
"totals": { "events": 245, "unique_users": 18 }
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
2. Stats journalières (graphiques)
|
|
|
|
GET /api/events/stats/daily?from=2025-12-01&to=2025-12-22&events=passage_created,login_success
|
|
|
|
| Param | Type | Requis | Description |
|
|
| ------ | ------ | ------ | ------------------------------- |
|
|
| from | string | Oui | Date début YYYY-MM-DD |
|
|
| to | string | Oui | Date fin YYYY-MM-DD |
|
|
| events | string | Non | Types filtrés (comma-separated) |
|
|
|
|
Limite : 90 jours max
|
|
|
|
Réponse (~5 KB) :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"from": "2025-12-01",
|
|
"to": "2025-12-22",
|
|
"days": [
|
|
{
|
|
"date": "2025-12-01",
|
|
"events": {
|
|
"passage_created": { "count": 45, "sum_amount": 850.00, "unique_users": 8 },
|
|
"login_success": { "count": 12, "sum_amount": 0, "unique_users": 12 }
|
|
},
|
|
"totals": { "count": 57, "sum_amount": 850.00 }
|
|
},
|
|
...
|
|
]
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
3. Stats hebdomadaires
|
|
|
|
GET /api/events/stats/weekly?from=2025-10-01&to=2025-12-22
|
|
|
|
| Param | Type | Requis | Description |
|
|
| ------ | ------ | ------ | ------------- |
|
|
| from | string | Oui | Date début |
|
|
| to | string | Oui | Date fin |
|
|
| events | string | Non | Types filtrés |
|
|
|
|
Limite : 365 jours max
|
|
|
|
Réponse (~2 KB) :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"from": "2025-10-01",
|
|
"to": "2025-12-22",
|
|
"weeks": [
|
|
{
|
|
"week_start": "2025-12-16",
|
|
"week_number": 51,
|
|
"year": 2025,
|
|
"events": {
|
|
"passage_created": { "count": 320, "sum_amount": 5200.00, "unique_users": 15 }
|
|
},
|
|
"totals": { "count": 450, "sum_amount": 5200.00 }
|
|
},
|
|
...
|
|
]
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
4. Stats mensuelles
|
|
|
|
GET /api/events/stats/monthly?year=2025&events=passage_created,stripe_payment_success
|
|
|
|
| Param | Type | Requis | Description |
|
|
| ------ | ------ | ------ | ------------------------------ |
|
|
| year | int | Non | Année (défaut: année courante) |
|
|
| events | string | Non | Types filtrés |
|
|
|
|
Réponse (~1 KB) :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"year": 2025,
|
|
"months": [
|
|
{
|
|
"month": "2025-01",
|
|
"year": 2025,
|
|
"month_number": 1,
|
|
"events": {
|
|
"passage_created": { "count": 1250, "sum_amount": 18500.00, "unique_users": 25 }
|
|
},
|
|
"totals": { "count": 1800, "sum_amount": 18500.00 }
|
|
},
|
|
...
|
|
]
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
5. Détail des événements (drill-down)
|
|
|
|
GET /api/events/stats/details?date=2025-12-22&event=login_failed&limit=50&offset=0
|
|
|
|
| Param | Type | Requis | Description |
|
|
| ------ | ------ | ------ | ------------------------------------ |
|
|
| date | string | Oui | Date YYYY-MM-DD |
|
|
| event | string | Non | Filtrer par type |
|
|
| limit | int | Non | Max résultats (défaut: 50, max: 100) |
|
|
| offset | int | Non | Pagination (défaut: 0) |
|
|
|
|
Réponse (~10 KB) :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"date": "2025-12-22",
|
|
"events": [
|
|
{
|
|
"timestamp": "2025-12-22T08:15:32Z",
|
|
"event": "login_failed",
|
|
"username": "jean.dupont",
|
|
"reason": "invalid_password",
|
|
"attempt": 2,
|
|
"ip": "192.168.x.x",
|
|
"platform": "ios",
|
|
"app_version": "3.5.2"
|
|
},
|
|
...
|
|
],
|
|
"pagination": {
|
|
"total": 3,
|
|
"limit": 50,
|
|
"offset": 0,
|
|
"has_more": false
|
|
}
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
6. Types d'événements disponibles
|
|
|
|
GET /api/events/stats/types
|
|
|
|
Réponse :
|
|
{
|
|
"status": "success",
|
|
"data": {
|
|
"auth": ["login_success", "login_failed", "logout"],
|
|
"passages": ["passage_created", "passage_updated", "passage_deleted"],
|
|
"sectors": ["sector_created", "sector_updated", "sector_deleted"],
|
|
"users": ["user_created", "user_updated", "user_deleted"],
|
|
"entities": ["entity_created", "entity_updated", "entity_deleted"],
|
|
"operations": ["operation_created", "operation_updated", "operation_deleted"],
|
|
"stripe": ["stripe_payment_created", "stripe_payment_success", "stripe_payment_failed", "stripe_payment_cancelled", "stripe_terminal_error"]
|
|
}
|
|
}
|
|
|
|
---
|
|
|
|
Codes d'erreur
|
|
|
|
| Code | Signification |
|
|
| ---- | -------------------------------------------- |
|
|
| 200 | Succès |
|
|
| 400 | Paramètre invalide (date, plage trop grande) |
|
|
| 403 | Accès refusé (rôle insuffisant) |
|
|
| 500 | Erreur serveur |
|
|
|
|
---
|
|
|
|
Super-admin uniquement
|
|
|
|
Le super-admin peut ajouter ?entity_id=X pour filtrer par entité :
|
|
GET /api/events/stats/summary?date=2025-12-22&entity_id=5
|
|
|
|
Sans ce paramètre, il voit les stats globales de toutes les entités.
|