المهنيين

نقاط النهاية للحصول على معلومات محترفي النشاط التجاري.

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