API - Profesionales | SalonBookIt Developers

GET /api/v1/peluqueros/

Lista todos los profesionales activos.

Query parameters

Parametro	Tipo	Descripcion
`servicio_id`	integer	Filtrar por profesionales que ofrecen un servicio
`disponible_hoy`	boolean	Solo profesionales disponibles hoy

Ejemplo de peticion

cURL

curl -X GET "https://app.salonbookit.com/api/v1/peluqueros/" \
  -H "X-API-Key: hh_live_abc123..."

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "profesionales": [
            {
                "id": 5,
                "nombre": "Carlos Garcia",
                "cargo": "Barbero Senior",
                "bio": "10 años de experiencia en cortes clasicos y modernos",
                "imagen_url": "https://app.salonbookit.com/media/staff/carlos.jpg",
                "especialidades": ["Cortes clasicos", "Afeitado tradicional"],
                "valoracion_media": 4.9,
                "total_resenas": 87,
                "servicios_ids": [15, 16, 17, 20]
            },
            {
                "id": 8,
                "nombre": "Miguel Lopez",
                "cargo": "Barbero",
                "bio": "Especialista en degradados y estilos modernos",
                "imagen_url": "https://app.salonbookit.com/media/staff/miguel.jpg",
                "especialidades": ["Degradados", "Diseños"],
                "valoracion_media": 4.7,
                "total_resenas": 52,
                "servicios_ids": [15, 16, 18, 19]
            }
        ],
        "total": 5
    }
}

Campos de respuesta

Campo	Tipo	Descripcion
`id`	integer	ID unico del profesional
`nombre`	string	Nombre completo
`cargo`	string	Puesto o titulo
`bio`	string	Biografia o descripcion
`imagen_url`	string\|null	URL de la foto
`especialidades`	array	Lista de especialidades
`valoracion_media`	number	Valoracion promedio (1-5)
`servicios_ids`	array	IDs de servicios que ofrece

GET /api/v1/peluqueros/{id}/

Obtiene el detalle de un profesional especifico.

Path parameters

Parametro	Tipo	Descripcion
`id`	integer	ID del profesional

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "id": 5,
        "nombre": "Carlos Garcia",
        "cargo": "Barbero Senior",
        "bio": "10 años de experiencia en cortes clasicos y modernos. Formado en las mejores escuelas de barberia de Europa.",
        "imagen_url": "https://app.salonbookit.com/media/staff/carlos.jpg",
        "galeria": [
            "https://app.salonbookit.com/media/staff/carlos-work-1.jpg",
            "https://app.salonbookit.com/media/staff/carlos-work-2.jpg"
        ],
        "especialidades": ["Cortes clasicos", "Afeitado tradicional", "Arreglo de barba"],
        "valoracion_media": 4.9,
        "total_resenas": 87,
        "servicios": [
            {
                "id": 15,
                "nombre": "Corte Clasico",
                "precio": 25.00,
                "duracion_minutos": 30
            },
            {
                "id": 16,
                "nombre": "Afeitado Clasico",
                "precio": 15.00,
                "duracion_minutos": 20
            }
        ],
        "horario": [
            {"dia": 1, "dia_nombre": "Lunes", "trabaja": true, "desde": "09:00", "hasta": "20:00"},
            {"dia": 2, "dia_nombre": "Martes", "trabaja": true, "desde": "09:00", "hasta": "20:00"},
            {"dia": 3, "dia_nombre": "Miercoles", "trabaja": true, "desde": "09:00", "hasta": "20:00"},
            {"dia": 4, "dia_nombre": "Jueves", "trabaja": true, "desde": "09:00", "hasta": "20:00"},
            {"dia": 5, "dia_nombre": "Viernes", "trabaja": true, "desde": "09:00", "hasta": "20:00"},
            {"dia": 6, "dia_nombre": "Sabado", "trabaja": true, "desde": "10:00", "hasta": "14:00"},
            {"dia": 7, "dia_nombre": "Domingo", "trabaja": false, "desde": null, "hasta": null}
        ],
        "resenas_recientes": [
            {
                "id": 123,
                "cliente_nombre": "Juan P.",
                "valoracion": 5,
                "comentario": "Excelente corte, muy profesional",
                "fecha": "2024-01-10"
            }
        ]
    }
}

GET /api/v1/peluqueros/{id}/horario/

Obtiene el horario de trabajo de un profesional.

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "profesional_id": 5,
        "nombre": "Carlos Garcia",
        "horario_semanal": [
            {
                "dia": 1,
                "dia_nombre": "Lunes",
                "trabaja": true,
                "turnos": [
                    {"desde": "09:00", "hasta": "14:00"},
                    {"desde": "16:00", "hasta": "20:00"}
                ]
            },
            {
                "dia": 2,
                "dia_nombre": "Martes",
                "trabaja": true,
                "turnos": [
                    {"desde": "09:00", "hasta": "20:00"}
                ]
            }
            // ... resto de dias
        ],
        "excepciones": [
            {
                "fecha": "2024-01-15",
                "motivo": "Dia libre",
                "trabaja": false
            }
        ]
    }
}