before gemiin

skills/jardin-api-backend/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: jardin-api-backend
+description: Ajouter ou mettre à jour des données dans le backend Jardin depuis OpenClaw/VM du réseau local via API HTTP (jardins, plantes, plantations, tâches, outils, astuces, médias, pièces jointes URL). Utiliser ce skill quand il faut produire des requêtes API prêtes à exécuter, définir l'ordre des appels avec dépendances d'ID, gérer l'upload de fichiers, et vérifier les endpoints de test backend.
+---
+
+# Jardin API Backend
+
+## Vue d'ensemble
+
+Utiliser ce skill pour construire des appels API backend fiables et directement exploitables dans OpenClaw.
+Lire `references/backend-api-recipes.md` pour les endpoints, payloads et séquences d'injection.
+
+## Procédure standard
+
+1. Identifier la base API cible (`http://<IP_HOTE>:8060` en LAN).
+2. Tester la connectivité (`GET /api/health`) avant toute écriture.
+3. Déterminer l'ordre des créations selon les dépendances d'ID:
+   - jardin -> plante -> plantation -> tâche
+4. Générer les requêtes OpenClaw avec:
+   - méthode
+   - URL complète
+   - headers
+   - body JSON ou multipart
+   - code HTTP attendu
+5. Stocker les IDs retournés et les réinjecter dans les appels suivants.
+6. Vérifier la lecture (`GET`) après création/mise à jour.
+
+## Format de sortie attendu
+
+Quand un utilisateur demande "comment injecter X", produire:
+
+1. Une séquence d'appels ordonnée numériquement.
+2. Pour chaque appel:
+   - `method`
+   - `url`
+   - `headers`
+   - `json` ou `form-data`
+   - `expected_status`
+   - `output_mapping` (IDs/URLs à réutiliser)
+3. Un équivalent `curl` minimal.
+
+## Contraintes et garde-fous
+
+Respecter ces règles:
+
+- Ne pas inventer d'authentification: l'API actuelle est sans token.
+- Utiliser `Content-Type: application/json` pour les endpoints JSON.
+- Utiliser `multipart/form-data` uniquement pour `POST /api/upload`.
+- Utiliser les dates au format `YYYY-MM-DD`.
+- Pour les mises à jour, envoyer un objet complet cohérent avec le modèle cible.
+- Pour les tâches, recommander `planting_id` même si techniquement optionnel.
+
+## Points OpenClaw à rappeler
+
+- Base API OpenClaw: `http://<IP_HOTE>:8060`
+- Test rapide: `/api/health`
+- Docs API: `/docs` et `/redoc`
+- Timeout recommandé: `15-30s`
+- Retry recommandé: `2-3` tentatives sur erreurs réseau
+
+## Ressource à charger
+
+Lire `references/backend-api-recipes.md` pour:
+- templates de payload
+- endpoints CRUD principaux
+- upload + association média
+- ajout de lien URL via `attachments`
+- séquences de création complètes