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
}
}
}