API - Professionnels | SalonBookIt Developers

GET /api/v1/peluqueros/

Liste tous les professionnels actifs.

Paramètres de requête

Paramètre	Type	Description
`servicio_id`	integer	Filtrer par professionnels offrant un service
`disponible_hoy`	boolean	Uniquement les professionnels disponibles aujourd'hui

Exemple de requête

cURL

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

Réponse (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
    }
}

Champs de réponse

Champ	Type	Description
`id`	integer	ID unique du professionnel
`nombre`	string	Nom complet
`cargo`	string	Poste ou titre
`bio`	string	Biographie ou description
`imagen_url`	string\|null	URL de la photo
`especialidades`	array	Liste des spécialités
`valoracion_media`	number	Note moyenne (1-5)
`servicios_ids`	array	IDs des services qu'il offre

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

Obtient le détail d'un professionnel spécifique.

Paramètres de chemin

Paramètre	Type	Description
`id`	integer	ID du professionnel

Réponse (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/

Obtient l'horaire de travail d'un professionnel.

Réponse (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"}
                ]
            }
            // ... reste des jours
        ],
        "excepciones": [
            {
                "fecha": "2024-01-15",
                "motivo": "Día libre",
                "trabaja": false
            }
        ]
    }
}