# API SAM - Exports

[← Progression](04-progress.md) | [Accueil](README.md)

---

Exports de statistiques au format Excel ou PDF.

**Base URL :** `/api/moodlev5/export`

---

## Endpoints

| Méthode | Route | Description |
|---------|-------|-------------|
| GET | `/export/users/{moodle_id}` | Export statistiques stagiaire |
| GET | `/export/courses/{moodle_id}` | Export statistiques cours |

---

## GET /export/users/{moodle_id}

Exporte les statistiques d'un stagiaire.

**Paramètres query :**

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| format | string | `excel`, `pdf` | Format d'export |

**Exemple :**

```bash
# Export Excel
curl -X GET "https://votre-domaine.com/api/moodlev5/export/users/123?format=excel" \
  -H "X-API-Key: bubul_sk_xxx" \
  -o stagiaire_123.xlsx

# Export PDF
curl -X GET "https://votre-domaine.com/api/moodlev5/export/users/123?format=pdf" \
  -H "X-API-Key: bubul_sk_xxx" \
  -o stagiaire_123.pdf
```

**Réponse :**

Fichier binaire (Excel ou PDF) avec les headers appropriés :
- `Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet` (Excel)
- `Content-Type: application/pdf` (PDF)
- `Content-Disposition: attachment; filename="user_123_stats.xlsx"`

---

## GET /export/courses/{moodle_id}

Exporte les statistiques d'un cours.

**Paramètres query :**

| Paramètre | Type | Valeurs | Description |
|-----------|------|---------|-------------|
| format | string | `excel`, `pdf` | Format d'export |

**Exemple :**

```bash
# Export Excel
curl -X GET "https://votre-domaine.com/api/moodlev5/export/courses/45?format=excel" \
  -H "X-API-Key: bubul_sk_xxx" \
  -o cours_45.xlsx

# Export PDF
curl -X GET "https://votre-domaine.com/api/moodlev5/export/courses/45?format=pdf" \
  -H "X-API-Key: bubul_sk_xxx" \
  -o cours_45.pdf
```

**Réponse :**

Fichier binaire contenant :
- Liste des stagiaires inscrits
- Progression de chaque stagiaire
- Statistiques globales (moyenne, taux de complétion)
- Détail par section/activité