Cuisines

Les cuisines représentent des lieux physiques où des aliments sont préparés, produits ou vendus. Chaque cuisine peut contenir plusieurs recettes, produits et fournitures.

Aperçu

Utilisez la Kitchen API pour :

• Créer et gérer des restaurants
• Configurer des sites de production ou des points de vente
• Définir la langue de chaque site
• Regrouper les recettes et les fournitures par site pour les rapports

Licence requise

Chaque cuisine doit disposer d'une licence pour calculer des données d'empreinte environnementale. Contactez info@eaternity.ch pour activer des cuisines.

Propriétés de la cuisine

Schéma de request et de response

{
  "kitchen": {
    "name": "Kitchen Restaurant A",
    "location": "Zurich, Switzerland",
    "email": "kitchen-a@test-customer.com",
    "language": "en",
    "id": "kitchen-restaurant-a"
  }
}

Définition des propriétés

Propriété	Type	Obligatoire	Description
name	String	Oui	Nom officiel de la cuisine ou de l'usine
location	String	Oui	Lieu où se trouve la cuisine. Adresse ou pays (format libre).
email	String	Non	Adresse e-mail à laquelle les rapports sont envoyés
language	String	Non	Langue des rapports de la cuisine
id	String	Non	Identifiant de la cuisine. Généré par Eaternity ou fourni par le client. Doit être alphanumérique (tirets et tirets bas autorisés).

Langues prises en charge

Le champ language détermine la langue utilisée pour :

• Les titres et descriptions des recettes
• Les noms des ingrédients
• Les messages d'erreur
• Les notifications par e-mail

Langues disponibles

Code	Langue
en	Anglais
de	Allemand
fr	Français
it	Italien
es	Espagnol

Si aucune langue n'est indiquée, l'API utilise l'anglais (en) par défaut.

Réponses d'erreur

403 Forbidden

Cuisine sans licence :

{
  "error": "Forbidden",
  "message": "Kitchen 550e8400-e29b-41d4-a716-446655440000 is not licensed for environmental calculations",
  "status": 403
}

404 Not Found

La cuisine n'existe pas. Le body est du texte brut :

GET /kitchens/does-not-exist

Kitchen not found

Risque de perte de données

Supprimer une cuisine supprime définitivement toutes les recettes, produits, fournitures et données historiques associés. Cette action est irréversible.

Endpoints

📄️ Create new kitchen

Creates a new kitchen. If the kitchen id is not provided, a new id is generated.

📄️ Get all kitchens

Returns a list of kitchen IDs belonging to this client (API key).

📄️ Get a kitchen

Retrieves the complete kitchen resource.

📄️ Create or update a kitchen

Update or create the kitchen with the specified ID.

📄️ Delete a kitchen

Deletes this kitchen from the server and also all data that is related to this kitchen.