API – Flux Dashboard Campus
===========================

Cette API permet d’accéder en temps réel aux données du dashboard Campus
(statistiques, historique, derniers invités, etc.).
L’accès est protégé par une clé API fournie séparément.

------------------------------------------------------------
1. URL d’accès
------------------------------------------------------------

JSON (format recommandé)
https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API

XML
https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API&format=xml

Jour spécifique (ex. 2025-01-01)
https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API&day=2025-01-01

------------------------------------------------------------
2. Authentification
------------------------------------------------------------

- L’accès se fait via key=VOTRE_CLE_API
- Si la clé est incorrecte → HTTP 403 Forbidden
- Aucun autre système d’authentification n’est nécessaire

------------------------------------------------------------
3. Structure du JSON renvoyé
------------------------------------------------------------

Le fichier contient 5 blocs principaux :

- meta
- stats
- days
- hourly
- last_invites

Exemple simplifié :

{
  "meta": {
    "generated_at": "2025-01-22T01:42:13+01:00",
    "selected_day": "2025-01-22"
  },
  "stats": {
    "total_invites": 2034,
    "total_nouveaux_arrivants": 351,
    "total_staff": 842,
    "invites_today": 124,
    "invites_last_60": 18
  },
  "days": [
    { "date": "2025-01-15", "total": 350 },
    { "date": "2025-01-16", "total": 420 }
  ],
  "hourly": {
    "labels": ["00h","01h","02h", ... "23h"],
    "values": [0, 2, 1, ...]
  },
  "last_invites": [
    {
      "id": 15592,
      "invite_prenom": "Laura",
      "invite_nom": "Martin",
      "invite_full": "Laura Martin",
      "staff_prenom": "Jean",
      "staff_nom": "Dubois",
      "staff_full": "Jean Dubois",
      "created_at": "2025-01-22 01:39:44"
    }
  ]
}

------------------------------------------------------------
4. Description des sections
------------------------------------------------------------

4.1 meta
- generated_at : date/heure ISO8601
- selected_day : jour utilisé pour le tableau "hourly"

4.2 stats
- total_invites
- total_nouveaux_arrivants
- total_staff
- invites_today
- invites_last_60

4.3 days
Chaque entrée contient :
- date (YYYY-MM-DD)
- total (invités ce jour-là)

4.4 hourly
- labels (24 valeurs de "00h" à "23h")
- values (24 entiers)

4.5 last_invites
Chaque entrée contient :
- id
- invite_prenom / invite_nom / invite_full
- staff_prenom / staff_nom / staff_full
- created_at (timestamp)

------------------------------------------------------------
5. Codes d’erreur
------------------------------------------------------------

403 Forbidden
{ "error": "Accès refusé (clé API invalide)." }

500 Internal Server Error
{ "error": "Erreur interne.", "message": "Détail." }

------------------------------------------------------------
6. Conseils d’intégration
------------------------------------------------------------

- Rafraîchir toutes les 5–10 secondes maximum.
- "days" et "hourly" sont parfaits pour les graphiques.
- "last_invites" permet un flux d’activité en direct (live feed).

------------------------------------------------------------
7. Exemples de code pour consommer l’API
------------------------------------------------------------

--- PHP ---
<?php
$url = "https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API";

$data = file_get_contents($url);
$json = json_decode($data, true);

echo "<h1>Invités aujourd'hui : " . $json['stats']['invites_today'] . "</h1>";

echo "<h2>Derniers invités :</h2>";
foreach ($json['last_invites'] as $invite) {
    echo "- " . $invite['invite_full'] . " (staff: " . $invite['staff_full'] . ")<br>";
}
?>

--- Python ---
import requests

url = "https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API"
data = requests.get(url).json()

print("Invités aujourd'hui :", data["stats"]["invites_today"])

print("\nDerniers invités :")
for entry in data["last_invites"]:
    print("-", entry["invite_full"], "| Staff:", entry["staff_full"])

--- JavaScript (fetch + HTML) ---
fetch("https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API")
  .then(res => res.json())
  .then(data => {
    document.getElementById("today").innerText = data.stats.invites_today;

    let list = "";
    data.last_invites.forEach(inv => {
      list += `<li>${inv.invite_full} (staff: ${inv.staff_full})</li>`;
    });
    document.getElementById("list").innerHTML = list;
  });

HTML minimal :
<p>Invités aujourd'hui : <span id="today"></span></p>
<ul id="list"></ul>

----------------------

exemple 


<?php
// =========================================================
//  monitor.php - Affichage des données API + DEBUG
// =========================================================

// --- DEBUG PHP (à laisser le temps des tests) ---
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

// URL du flux (remettre ta clé API)
$apiUrl = "https://dev.campus.cul.nu/dashboard_feed.php?key=VOTRE_CLE_API_ICI";

// ---------- FONCTION POUR APPELER L'API ----------

function callApi($url) {
    // 1) Tentative avec file_get_contents
    $data = @file_get_contents($url);
    if ($data !== false && strlen($data) > 0) {
        return $data;
    }

    // 2) Fallback avec cURL
    if (!function_exists('curl_init')) {
        return false;
    }

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL            => $url,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_TIMEOUT        => 10,
        CURLOPT_SSL_VERIFYPEER => false, // à durcir si nécessaire
        CURLOPT_SSL_VERIFYHOST => false,
    ]);
    $response = curl_exec($ch);
    $err      = curl_error($ch);
    $code     = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($response === false) {
        echo "<p style='color:red'>Erreur cURL : " . htmlspecialchars($err) . " (HTTP $code)</p>";
        return false;
    }

    if ($code !== 200) {
        echo "<p style='color:red'>Erreur HTTP : $code</p>";
    }

    return $response;
}

// ---------- APPEL API ----------

$jsonRaw = callApi($apiUrl);

if (!$jsonRaw) {
    die("Erreur : impossible de charger le flux API.");
}

// Pour vérifier ce que renvoie l'API en cas de doute :
// echo "<pre>"; echo htmlspecialchars($jsonRaw); echo "</pre>"; exit;

$data = json_decode($jsonRaw, true);

if (!$data) {
    echo "<pre>JSON brut :\n" . htmlspecialchars($jsonRaw) . "</pre>";
    die("Erreur : format JSON invalide. Détail : " . json_last_error_msg());
}

// Vérif de la structure attendue
if (!isset($data["stats"], $data["hourly"], $data["last_invites"], $data["meta"])) {
    echo "<pre>JSON décodé :\n" . htmlspecialchars(print_r($data, true)) . "</pre>";
    die("Erreur : structure inattendue dans la réponse API.");
}

// Raccourcis
$stats       = $data["stats"];
$days        = $data["days"] ?? [];
$hourly      = $data["hourly"];
$lastInvites = $data["last_invites"];

?>
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <title>Monitoring Campus</title>

    <!-- Bootstrap -->
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet">

    <!-- Chart.js -->
    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>

    <style>
        body { background:#f8f9fa; }
        .card { border-radius:10px; }
    </style>
</head>

<body>
<div class="container py-4">

    <h1 class="mb-4">📊 Monitoring Campus</h1>

    <!-- ====== Stats ====== -->
    <div class="row g-3 mb-4">

        <div class="col-md-3">
            <div class="card shadow-sm p-3">
                <h6 class="text-muted">Invités total</h6>
                <p class="h3 m-0"><?php echo (int)$stats["total_invites"]; ?></p>
            </div>
        </div>

        <div class="col-md-3">
            <div class="card shadow-sm p-3">
                <h6 class="text-muted">Nouveaux arrivants</h6>
                <p class="h3 m-0"><?php echo (int)$stats["total_nouveaux_arrivants"]; ?></p>
            </div>
        </div>

        <div class="col-md-3">
            <div class="card shadow-sm p-3">
                <h6 class="text-muted">Staff inscrit</h6>
                <p class="h3 m-0"><?php echo (int)$stats["total_staff"]; ?></p>
            </div>
        </div>

        <div class="col-md-3">
            <div class="card shadow-sm p-3">
            <h6 class="text-muted">Invités aujourd'hui</h6>
                <p class="h3 m-0"><?php echo (int)$stats["invites_today"]; ?></p>
            </div>
        </div>

        <div class="col-md-3">
            <div class="card shadow-sm p-3">
                <h6 class="text-muted">Invités (60 dernières min)</h6>
                <p class="h3 m-0"><?php echo (int)$stats["invites_last_60"]; ?></p>
            </div>
        </div>

    </div>


    <!-- ====== Graphique par heure ====== -->
    <div class="card shadow-sm mb-4">
        <div class="card-body">
            <h5 class="mb-3">
                🕒 Invités par heure
                (<?php echo htmlspecialchars($data["meta"]["selected_day"] ?? ''); ?>)
            </h5>
            <canvas id="chartHour"></canvas>
        </div>
    </div>

    <!-- ====== Derniers invités ====== -->
    <div class="card shadow-sm mb-4">
        <div class="card-body">
            <h5 class="mb-3">🧍 Derniers invités</h5>

            <?php if (empty($lastInvites)): ?>
                <p class="text-muted">Aucun invité trouvé.</p>
            <?php else: ?>
                <table class="table table-sm table-hover">
                    <thead>
                        <tr>
                            <th>ID</th>
                            <th>Invité</th>
                            <th>Staff</th>
                            <th>Date / heure</th>
                        </tr>
                    </thead>
                    <tbody>
                    <?php foreach ($lastInvites as $inv): ?>
                        <tr>
                            <td><?php echo (int)$inv["id"]; ?></td>
                            <td><?php echo htmlspecialchars($inv["invite_full"]); ?></td>
                            <td><?php echo htmlspecialchars($inv["staff_full"]); ?></td>
                            <td><?php echo htmlspecialchars($inv["created_at"]); ?></td>
                        </tr>
                    <?php endforeach; ?>
                    </tbody>
                </table>
            <?php endif; ?>

        </div>
    </div>

</div>

<!-- ==== SCRIPT GRAPHIQUE ==== -->
<script>
const ctx = document.getElementById('chartHour').getContext('2d');

new Chart(ctx, {
    type: 'line',
    data: {
        labels: <?php echo json_encode($hourly["labels"]); ?>,
        datasets: [{
            label: 'Invités par heure',
            data: <?php echo json_encode($hourly["values"]); ?>,
            borderWidth: 2,
            borderColor: '#007bff',
            backgroundColor: 'rgba(0,123,255,0.2)',
            tension: 0.3,
            fill: true,
            pointRadius: 2
        }]
    },
    options: {
        responsive: true,
        scales: {
            y: { beginAtZero: true }
        }
    }
});
</script>

</body>
</html>