jardin/skills/jardin-api-backend/SKILL.md

name, description

name	description
jardin-api-backend	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