Restofy Docs
Habitaciones del negocio POST

Listar habitaciones

POST /api/rooms/list-rooms-admin

Descripción

Listado paginado de todas las habitaciones del alojamiento, incluyendo las pausadas.

Detalles

Devuelve las habitaciones con su nombre, ubicación, capacidad y estado. Acepta búsqueda libre sobre el nombre y la ubicación. Las habitaciones eliminadas no aparecen en el listado.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
search string No
max:100

Paginación

defaultLimit 100
maxLimit 200
defaultSort sortOrder
defaultDir asc
withTotal true
allowedSorts [sortOrder, name, capacity]

Ejemplo de request

curl -X POST https://restofy.pro/api/rooms/list-rooms-admin \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>"

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "search": "Hab listada 6aa03929a888e"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "rooms": [
            {
                "roomId": 6,
                "roomUuid": "ae1a988f-ab4a-11f1-b72d-f2569efa6eee",
                "name": "Hab listada 6aa03929a888e",
                "location": null,
                "capacity": 2,
                "sortOrder": 5,
                "isActive": 1,
                "isAvailable": 1
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 100,
            "total": 1,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}