---
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