Küchen

Küchen sind physische Standorte, an denen Lebensmittel zubereitet, produziert oder verkauft werden. Jede Küche kann mehrere Rezepte, Produkte und Einkäufe enthalten.

Überblick

Verwenden Sie die Kitchen API, um:

• Restaurantstandorte anzulegen und zu verwalten
• Produktionsbetriebe oder Verkaufsstellen einzurichten
• Spracheinstellungen pro Standort festzulegen
• Rezepte und Einkäufe für Berichte nach Standort zu gruppieren

Lizenzpflicht

Jede Küche muss lizenziert sein, damit Umweltdaten berechnet werden. Kontaktieren Sie info@eaternity.ch, um Küchen zu aktivieren.

Küchen-Eigenschaften

Request-/Response-Schema

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

Eigenschaften im Detail

Eigenschaft	Typ	Pflicht	Beschreibung
name	String	Ja	Offizieller Name der Küche oder des Betriebs
location	String	Ja	Ort, an dem sich die Küche befindet. Adresse oder Land (beliebiges Format).
email	String	Nein	E-Mail-Adresse, an die Berichte gesendet werden
language	String	Nein	Sprache der Berichte für die Küche
id	String	Nein	Küchen-id. Entweder von Eaternity erzeugt oder vom Client gesetzt. Muss alphanumerisch sein (Bindestriche und Unterstriche erlaubt).

Sprachunterstützung

Das Feld language steuert die Sprache von:

• Rezepttiteln und -beschreibungen
• Zutatennamen
• Fehlermeldungen
• E-Mail-Benachrichtigungen

Unterstützte Sprachen

Code	Sprache
en	Englisch
de	Deutsch
fr	Französisch
it	Italienisch
es	Spanisch

Ohne Sprachangabe verwendet die API Englisch (en).

Fehler-Responses

403 Forbidden

Küche nicht lizenziert:

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

404 Not Found

Die Küche existiert nicht. Der Body ist reiner Text:

GET /kitchens/does-not-exist

Kitchen not found

Warnung vor Datenverlust

Das Löschen einer Küche entfernt alle zugehörigen Rezepte, Produkte, Einkäufe und historischen Daten dauerhaft. Diese Aktion kann nicht rückgängig gemacht werden.

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.