Professionals
Endpoints to get business professionals information.
GET
/api/v1/peluqueros/
Lists all active professionals.
Query parameters
| Parameter | Type | Description |
|---|---|---|
servicio_id |
integer | Filter by professionals offering a service |
disponible_hoy |
boolean | Only professionals available today |
Request example
cURL
curl -X GET "https://app.salonbookit.com/api/v1/peluqueros/" \
-H "X-API-Key: hh_pub_live_abc123..."Response (200 OK)
JSON
{
"success": true,
"data": {
"profesionales": [
{
"id": 5,
"nombre": "Carlos García",
"cargo": "Barbero Senior",
"bio": "10 años de experiencia en cortes clásicos y modernos",
"imagen_url": "https://app.salonbookit.com/media/staff/carlos.jpg",
"especialidades": ["Cortes clásicos", "Afeitado tradicional"],
"valoracion_media": 4.9,
"total_resenas": 87,
"servicios_ids": [15, 16, 17, 20]
},
{
"id": 8,
"nombre": "Miguel López",
"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
}
}Response fields
| Field | Type | Description |
|---|---|---|
id |
integer | Unique professional ID |
nombre |
string | Full name |
cargo |
string | Position or title |
bio |
string | Biography or description |
imagen_url |
string|null | Photo URL |
especialidades |
array | List of specialties |
valoracion_media |
number | Average rating (1-5) |
servicios_ids |
array | Service IDs offered |
GET
/api/v1/peluqueros/{id}/
Gets the details of a specific professional.
Path parameters
| Parameter | Type | Description |
|---|---|---|
id |
integer | Professional ID |
Response (200 OK)
JSON
{
"success": true,
"data": {
"id": 5,
"nombre": "Carlos García",
"cargo": "Barbero Senior",
"bio": "10 años de experiencia en cortes clásicos y modernos. Formado en las mejores escuelas de barbería 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 clásicos", "Afeitado tradicional", "Arreglo de barba"],
"valoracion_media": 4.9,
"total_resenas": 87,
"servicios": [
{
"id": 15,
"nombre": "Corte Clásico",
"precio": 25.00,
"duracion_minutos": 30
},
{
"id": 16,
"nombre": "Afeitado Clásico",
"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": "Miércoles", "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": "Sábado", "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/
Gets a professional's work schedule.
Response (200 OK)
JSON
{
"success": true,
"data": {
"profesional_id": 5,
"nombre": "Carlos García",
"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"}
]
}
// ... remaining days
],
"excepciones": [
{
"fecha": "2024-01-15",
"motivo": "Día libre",
"trabaja": false
}
]
}
}