Cocinas
Las cocinas representan lugares físicos donde se preparan, producen o venden alimentos. Cada cocina puede contener varias recetas, productos y suministros.
Visión general
Usad la Kitchen API para:
- Crear y gestionar restaurantes
- Configurar instalaciones de producción o tiendas
- Definir el idioma de cada ubicación
- Agrupar recetas y suministros por ubicación para los informes
Cada cocina necesita una licencia para calcular datos de impacto ambiental. Escribid a info@eaternity.ch para activar las cocinas.
Propiedades de la cocina
Esquema de solicitud y respuesta
{
"kitchen": {
"name": "Kitchen Restaurant A",
"location": "Zurich, Switzerland",
"email": "kitchen-a@test-customer.com",
"language": "en",
"id": "kitchen-restaurant-a"
}
}
Definiciones de las propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | String | Sí | Nombre oficial de la cocina o fábrica |
location | String | Sí | Lugar donde se encuentra la cocina. Dirección o país (formato libre). |
email | String | No | Dirección de correo electrónico a la que se envían los informes |
language | String | No | Idioma de los informes de la cocina |
id | String | No | Identificador de la cocina. Lo genera Eaternity o lo indica el cliente. Debe ser alfanumérico (se permiten guiones y guiones bajos). |
Idiomas
El campo language define el idioma usado en:
- Títulos y descripciones de las recetas
- Nombres de los ingredientes
- Mensajes de error
- Notificaciones por correo electrónico
Idiomas disponibles
| Código | Idioma |
|---|---|
en | Inglés |
de | Alemán |
fr | Francés |
it | Italiano |
es | Español |
Si no se indica ningún idioma, la API usa el inglés (en).
Respuestas de error
403 Forbidden
Cocina sin licencia:
{
"error": "Forbidden",
"message": "Kitchen 550e8400-e29b-41d4-a716-446655440000 is not licensed for environmental calculations",
"status": 403
}
404 Not Found
La cocina no existe. El cuerpo es texto plano:
Kitchen not found
Eliminar una cocina borra de forma permanente todas las recetas, productos, suministros y datos históricos asociados. Esta acción no se puede deshacer.
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.