/

.gemini/skills/frontend-creator/references/api_usage.md

@@ -0,0 +1,29 @@
+# Utilisation de l'API (Client JS)
+
+Le frontend utilise une classe globale `BenchAPI` (instanciée sous `window.BenchAPI` ou `apiClient`).
+
+## Client API Global
+Le client est défini dans `js/api.js`.
+
+### Méthodes Communes
+- `getDevices(params)` : Liste les appareils.
+- `getDevice(deviceId)` : Détails d'un appareil.
+- `updateDevice(deviceId, data)` : Met à jour un appareil.
+- `getDeviceBenchmarks(deviceId, params)` : Historique des benchmarks.
+- `uploadDocument(deviceId, file, docType)` : Upload d'image ou PDF.
+
+### Exemple d'appel
+```javascript
+const apiClient = window.BenchAPI;
+
+try {
+  const devices = await apiClient.getDevices();
+  // Traiter les données
+} catch (error) {
+  console.error("Erreur API:", error);
+}
+```
+
+## Gestion des Erreurs
+L'API renvoie des erreurs détaillées. Utilisez `error.message` pour l'affichage à l'utilisateur.
+Le module `utils.js` (sous `window.BenchUtils`) propose des méthodes comme `showToast` ou `showError`.