# API · Le Club Airfryer Publie des recettes dans l'app **Le Club Airfryer** (iOS / Android) et choisit la recette à la une (« Inspiration du jour » en haut de l'accueil). Les changements sont visibles dans l'app **immédiatement** : il n'y a pas de brouillon côté app. - Base : `https://club-airfryer-api.lab.picorp.fr/api/v1` - Authentification : en-tête `Authorization: Bearer ` sur chaque requête. - Réponses en JSON ; en cas d'erreur : `{ "error": "message" }` (400 donnée invalide, 401 jeton, 404 introuvable, 409 conflit). - Aucune suppression possible par l'API (passer par https://leclubairfryer.com/admin). | Méthode | Chemin | Rôle | |---|---|---| | GET | `/recipes` | liste des recettes, la plus récente d'abord. Filtres : `?q=poulet`, `?category=Desserts`, `?premium=true\|false` | | GET | `/recipes/` | recette complète (ingrédients, étapes, rappels), dans le format accepté par POST / PATCH | | POST | `/recipes` | **publie** une nouvelle recette (avec sa photo) | | PATCH | `/recipes/` | modifie une recette existante (seuls les champs envoyés changent) | | GET | `/featured` | recette à la une actuelle | | PUT | `/featured` | change la recette à la une. Corps : `{ "recipeId": "" }` (`null` = première recette du catalogue) | | GET | `/schema` | catégories et difficultés acceptées | Avant de publier, vérifier avec `GET /recipes?q=…` qu'une recette proche n'existe pas déjà. Ajouter `?dryRun=true` à un POST ou un PATCH pour tout vérifier (champs, photo, doublons) sans rien écrire. ## Champs d'une recette | Champ | Obligatoire | Description | |---|---|---| | `id` | oui | identifiant et lien de partage (`https://leclubairfryer.com/recettes/`) : minuscules, chiffres, tirets, ex. `ailes-poulet-miel-soja`. Ne change plus ensuite. | | `title` | oui | titre (200 caractères max), ex. `Ailes de poulet miel-soja` | | `description` | oui | accroche d'une ou deux phrases (3000 max) | | `category` | oui | `Poulet`, `Viande`, `Poisson`, `Légumes`, `Végé`, `Petit-déj`, `Snacks` ou `Desserts` | | `difficulty` | oui | `facile`, `moyen` ou `difficile` | | `isPremium` | oui | `true` = réservée aux abonnés (paywall), `false` = gratuite | | `isTrending` | oui | `true` = apparaît dans « Tendances » | | `prepTimeMinutes` | oui | préparation, entier de 0 à 1440 | | `cookTimeMinutes` | oui | cuisson à l'airfryer, entier de 1 à 1440 (sert au chrono) | | `temperatureCelsius` | oui | entier de 30 à 300 | | `baseServings` | oui | portions de base, entier de 1 à 100 (l'app recalcule les quantités) | | `ingredients` | oui | 1 à 100 × `{ "name": "ailes de poulet", "quantity": 800, "unit": "g" }`. `unit` peut être `""` (ex. 2 œufs). Pour « sel, poivre » ou « huile en spray » : `"quantity": 0, "unit": "", "scalable": false` | | `steps` | oui | 1 à 100 étapes, en texte : `["Préchauffez l'airfryer à 200 °C.", "…"]` | | `midCookActions` | non | rappels du chrono pendant la cuisson : `[{ "atSeconds": 360, "label": "Retournez les ailes" }]`, `atSeconds` < durée de cuisson | | `videoUrl` | non | lien HTTPS d'une vidéo (TikTok, YouTube…) ou `null` | | `featured` | non | `true` = la mettre aussi à la une | Photo (obligatoire à la création, facultative en PATCH pour la remplacer), au choix : - `photoUrl` : URL publique HTTPS d'une image ; - `photoBase64` : image encodée en base64 (préfixe `data:image/…;base64,` accepté) ; - ou en `multipart/form-data` : un fichier `photo` + un champ `recipe` contenant le JSON de la recette. JPEG, PNG ou WebP, 25 Mo max. Elle est recadrée en 4:3 (centre), convertie en WebP léger et hébergée dans Firebase Storage : prévoir un plat bien centré, en format paysage. Ton des textes : français, vouvoiement (« Préchauffez… »), étapes courtes, une action par étape, la température et la durée rappelées dans l'étape de cuisson. ## Exemples (curl) ```sh TOKEN=... # jeton fourni API=https://club-airfryer-api.lab.picorp.fr/api/v1 # Publier une recette et la mettre à la une curl -X POST "$API/recipes" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -d '{ "id": "ailes-poulet-miel-soja", "title": "Ailes de poulet miel-soja", "description": "Des ailes laquées et croustillantes, prêtes en 25 minutes.", "category": "Poulet", "difficulty": "facile", "isPremium": false, "isTrending": true, "prepTimeMinutes": 10, "cookTimeMinutes": 22, "temperatureCelsius": 200, "baseServings": 4, "ingredients": [ { "name": "ailes de poulet", "quantity": 800, "unit": "g" }, { "name": "miel", "quantity": 30, "unit": "ml" }, { "name": "sauce soja", "quantity": 30, "unit": "ml" }, { "name": "sel et poivre", "quantity": 0, "unit": "", "scalable": false } ], "steps": [ "Mélangez le miel et la sauce soja.", "Enrobez les ailes de la moitié de la sauce.", "Faites cuire 22 minutes à 200 °C en les retournant à mi-cuisson.", "Badigeonnez du reste de sauce et servez." ], "midCookActions": [{ "atSeconds": 660, "label": "Retournez les ailes" }], "photoUrl": "https://exemple.com/ailes.jpg", "featured": true }' # Avec un fichier local curl -X POST "$API/recipes" -H "Authorization: Bearer $TOKEN" \ -F 'recipe={"id":"…", "title":"…", …}' -F photo=@ailes.jpg # Corriger une recette (seuls ces champs changent) curl -X PATCH "$API/recipes/ailes-poulet-miel-soja" -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" -d '{ "cookTimeMinutes": 20, "isTrending": false }' # Changer la recette à la une curl -X PUT "$API/featured" -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" -d '{ "recipeId": "etoile-feuilletee-nutella" }' ``` POST et PATCH renvoient la recette complète, avec `shareUrl` et `featured`. Un 409 sur PATCH signifie que la recette a été modifiée en même temps dans l'admin : relire (`GET`) et renvoyer.