Saltar al contenido principal
Versión: v0.7.1-beta

Spaces

Gestión de Espacios​

Los endpoints de espacios permiten administrar las áreas físicas del establecimiento.

GET /spaces​

Obtiene todos los espacios del establecimiento.

Authorization: spaces_read

cURL Example:

curl -X GET "http://127.0.0.1:9154/spaces" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Cookie: refreshToken=$REFRESH_TOKEN"

Response Body (Éxito - 200 OK):

[
  { "id": "9214936c-0d95-4101-97ac-a2f04e4929bd", "name": "Terraza" },
  { "id": "9008646f-b24b-4e14-9c4a-00cec2d124da", "name": "Salón Principal" }
]

Response Body (Lista vacía - 200 OK):

"No spaces found"

GET /spaces/{id}​

Obtiene un espacio específico por su ID.

Authorization: spaces_read

Path Parameters:

  • id (string): ID del espacio a obtener.

cURL Example:

curl -X GET "http://127.0.0.1:9154/spaces/34fe7489-74e9-4e7a-968a-66cd0cdc00d7" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Cookie: refreshToken=$REFRESH_TOKEN"

Response Body (Éxito - 200 OK):

{
  "id": "34fe7489-74e9-4e7a-968a-66cd0cdc00d7",
  "name": "Terraza"
}

POST /spaces​

Crea un nuevo espacio.

Authorization: spaces_create

Request Body:

{
  "name": "string"
}

cURL Example:

curl -X POST "http://127.0.0.1:9154/spaces" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Jardín Exterior" }'

Response Body (Éxito - 201 Created):

{
  "id": "cadd2c99-3a87-4fb6-802d-9a57b4c05ba5",
  "message": "Space added successfully"
}

PUT /spaces/{id}​

Actualiza un espacio existente.

Authorization: spaces_update

Path Parameters:

  • id (string): ID del espacio a actualizar.

Request Body:

{
  "name": "string"
}

cURL Example:

curl -X PUT "http://127.0.0.1:9154/spaces/9008646f-b24b-4e14-9c4a-00cec2d124da" \
  -H "Cookie: accessToken=$ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Terraza Renovada" }'

Response Body (Éxito - 200 OK):

{
  "id": "9008646f-b24b-4e14-9c4a-00cec2d124da",
  "message": "Space updated successfully"
}

DELETE /spaces/{id}​

Elimina un espacio del sistema.

Authorization: spaces_delete

Path Parameters:

  • id (string): ID del espacio a eliminar.

cURL Example:

curl -X DELETE "http://127.0.0.1:9154/spaces/9008646f-b24b-4e14-9c4a-00cec2d124da" \
  -H "Cookie: accessToken=$ACCESS_TOKEN"

Response: 204 No Content (sin cuerpo).

Response Body (Error - 400 Bad Request): si el espacio no existe o no puede eliminarse.

"Space not found"

Notas​

información
  • Los IDs de espacios son UUID generados automáticamente.
  • Un espacio puede contener múltiples mesas.
  • No se puede eliminar un espacio que tenga mesas asociadas (responde 400).