69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
---
|
|
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
|