المهنيين
نقاط النهاية للحصول على معلومات محترفي النشاط التجاري.
GET
/api/v1/peluqueros/
يسرد جميع المحترفين النشطين.
معلمات الاستعلام
| المعامل | النوع | الوصف |
|---|---|---|
servicio_id |
integer | تصفية حسب المحترفين الذين يقدمون خدمة |
disponible_hoy |
boolean | فقط المحترفين المتاحين اليوم |
مثال على الطلب
cURL
curl -X GET "https://app.salonbookit.com/api/v1/peluqueros/" \
-H "X-API-Key: hh_pub_live_abc123..."
الاستجابة (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
}
}
حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
id |
integer | المعرف الفريد للمحترف |
nombre |
string | الاسم الكامل |
cargo |
string | المنصب أو اللقب |
bio |
string | السيرة الذاتية أو الوصف |
imagen_url |
string|null | رابط الصورة |
especialidades |
array | قائمة التخصصات |
valoracion_media |
number | متوسط التقييم (1-5) |
servicios_ids |
array | معرفات الخدمات التي يقدمها |
GET
/api/v1/peluqueros/{id}/
يحصل على تفاصيل محترف معين.
معلمات المسار
| المعامل | النوع | الوصف |
|---|---|---|
id |
integer | معرف المحترف |
الاستجابة (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/
يحصل على جدول عمل المحترف.
الاستجابة (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"}
]
}
// ... بقية الأيام
],
"excepciones": [
{
"fecha": "2024-01-15",
"motivo": "Día libre",
"trabaja": false
}
]
}
}