Saltar al contenido principal

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: Requiere access token válido (enviado automáticamente via cookies)
    • cURL Example:
    curl -X GET "http://127.0.0.1:9154/spaces" \
    -H 'Cookie: accessToken=your_access_token_here' \
    -H 'Cokkie: refreshToken=your_refresh_token_here'
    • 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 (Sin contenido - 204 No Content):
    "No spaces found"
  • GET /spaces/{id}: Obtiene un espacio específico por su ID.

    • Authorization: Requiere access token válido (enviado automáticamente via cookies)
    • 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=your_access_token_here' \
    -H 'Cookie: refreshToken=your_refresh_token_here'
    • Response Body (Éxito - 200 OK):
    {
    "id": "34fe7489-74e9-4e7a-968a-66cd0cdc00d7",
    "name": "Terraza"
    }
    • Response Body (Error - 400 Bad Request):
    "Missing or malformed ID"
    • Response Body (Error - 404 Not Found):
    "Space not found"
  • POST /spaces: Crea un nuevo espacio.

    • Authorization: Requiere access token válido (enviado automáticamente via cookies)
    • Request Body:
    {
    "name": "string"
    }
    • cURL Example:
    curl -X POST "http://127.0.0.1:9154/spaces" \
    -H 'Cookie: accessToken=your_access_token_here' \
    -H 'Cokkie: refreshToken=your_refresh_token_here' \
    -H "Content-Type: application/json" \
    -d '{
    "name": "Jardín Exterior"
    }'
    • Response Body (Éxito - 201 Created):
    "Space added successfully"
  • PUT /spaces/{id}: Actualiza un espacio existente.

    • Authorization: Requiere access token válido (enviado automáticamente via cookies)
    • 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=your_access_token_here' \
    -H 'Cokkie: refreshToken=your_refresh_token_here' \
    -H "Content-Type: application/json" \
    -d '{
    "name": "Terraza Renovada"
    }'
    • Response Body (Éxito - 200 OK):
    "Space updated successfully"
    • Response Body (Error - 400 Bad Request):
    "Missing or malformed ID"
    • Response Body (Error - 404 Not Found):
    "Space not found"
  • DELETE /spaces/{id}: Elimina un espacio del sistema.

    • Authorization: Requiere access token válido (enviado automáticamente via cookies)
    • 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=your_access_token_here' \
    -H 'Cokkie: refreshToken=your_refresh_token_here' \
    • Response Body (Éxito - 200 OK):
    "Space deleted successfully"
    • Response Body (Error - 400 Bad Request):
    "Missing or malformed ID"
    • Response Body (Error - 400 Bad Request):
    "Space not found"

Notas importantes:

  • Todos los endpoints de espacios requieren autenticació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