Cucine
Le cucine rappresentano i luoghi fisici in cui gli alimenti vengono preparati, prodotti o venduti. Ogni cucina può contenere più ricette, prodotti e forniture.
Panoramica
Usate la Kitchen API per:
- Creare e gestire i ristoranti
- Configurare impianti di produzione o punti vendita
- Impostare la lingua di ciascuna sede
- Raggruppare ricette e forniture per sede ai fini dei report
Ogni cucina deve avere una licenza per calcolare i dati di impatto ambientale. Contattate info@eaternity.ch per attivare le cucine.
Proprietà della cucina
Schema di request/response
{
"kitchen": {
"name": "Kitchen Restaurant A",
"location": "Zurich, Switzerland",
"email": "kitchen-a@test-customer.com",
"language": "en",
"id": "kitchen-restaurant-a"
}
}
Definizione delle proprietà
| Proprietà | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
name | String | Sì | Nome ufficiale della cucina o dello stabilimento |
location | String | Sì | Luogo in cui si trova la cucina. Indirizzo o paese (formato libero). |
email | String | No | Indirizzo email a cui vengono inviati i report |
language | String | No | Lingua dei report della cucina |
id | String | No | Identificativo della cucina. Generato da Eaternity o fornito dal client. Deve essere alfanumerico (trattini e trattini bassi ammessi). |
Supporto delle lingue
Il campo language determina la lingua usata per:
- Titoli e descrizioni delle ricette
- Nomi degli ingredienti
- Messaggi di errore
- Notifiche email
Lingue supportate
| Codice | Lingua |
|---|---|
en | Inglese |
de | Tedesco |
fr | Francese |
it | Italiano |
es | Spagnolo |
Se non viene indicata alcuna lingua, l'API usa l'inglese (en).
Response di errore
403 Forbidden
Cucina senza licenza:
{
"error": "Forbidden",
"message": "Kitchen 550e8400-e29b-41d4-a716-446655440000 is not licensed for environmental calculations",
"status": 403
}
404 Not Found
La cucina non esiste. Il body è testo semplice:
Kitchen not found
Eliminando una cucina si rimuovono definitivamente tutte le ricette, i prodotti, le forniture e i dati storici associati. L'operazione non può essere annullata.
Endpoint
📄️ 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.