# API SentinelMesh

Base URL : `http://<host>:8080/api/v1/`

Toutes les réponses sont en JSON. Auth par token Bearer (header `Authorization: Bearer <token>`).

## Endpoints

### Santé

| Méthode | Endpoint         | Description        |
|---------|------------------|--------------------|
| GET     | `/api/v1/health` | État du backend    |

### Agents

| Méthode | Endpoint              | Description                    |
|---------|-----------------------|--------------------------------|
| GET     | `/api/v1/agents`      | Liste des agents enregistrés   |
| POST    | `/api/v1/agents`      | Enregistrement d'un agent      |
| GET     | `/api/v1/agents/{id}` | Détail d'un agent              |

### Réseau

| Méthode | Endpoint              | Description                        |
|---------|-----------------------|------------------------------------|
| GET     | `/api/v1/network`     | Équipements découverts             |
| POST    | `/api/v1/network`     | Push scan depuis agent             |
| GET     | `/api/v1/network/{ip}`| Détail d'un équipement             |

### Métriques

| Méthode | Endpoint              | Description                        |
|---------|-----------------------|------------------------------------|
| GET     | `/api/v1/metrics`     | Métriques de tous les agents       |
| POST    | `/api/v1/metrics`     | Push métriques depuis agent        |
| GET     | `/api/v1/metrics/{id}`| Métriques d'un agent               |

### Widgets (consommés par Glance)

| Méthode | Endpoint                      | Cache Glance |
|---------|-------------------------------|--------------|
| GET     | `/api/v1/widgets/network`     | 30s          |
| GET     | `/api/v1/widgets/metrics`     | 1s           |

### Événements

| Méthode | Endpoint              | Description              |
|---------|-----------------------|--------------------------|
| GET     | `/api/v1/events`      | Journal des événements   |
| POST    | `/api/v1/events`      | Push événement           |

### Installation / Mise à jour

| Méthode | Endpoint              | Description                    |
|---------|-----------------------|--------------------------------|
| GET     | `/api/v1/install`     | Commande d'installation        |
| GET     | `/api/v1/update`      | Commande de mise à jour        |

## Documentation interactive

Swagger UI disponible sur : `http://<host>:8080/swagger-ui/`