API - Fachleute | SalonBookIt Developers

GET /api/v1/peluqueros/

Listet alle aktiven Fachleute auf.

Query-Parameter

Parameter	Typ	Beschreibung
`servicio_id`	integer	Nach Fachleuten filtern, die einen Service anbieten
`disponible_hoy`	boolean	Nur heute verfügbare Fachleute

Anfrage-Beispiel

cURL

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

Antwort (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
    }
}

Antwortfelder

Feld	Typ	Beschreibung
`id`	integer	Eindeutige Fachmann-ID
`nombre`	string	Vollständiger Name
`cargo`	string	Position oder Titel
`bio`	string	Biografie oder Beschreibung
`imagen_url`	string\|null	Foto-URL
`especialidades`	array	Liste der Spezialisierungen
`valoracion_media`	number	Durchschnittliche Bewertung (1-5)
`servicios_ids`	array	IDs der angebotenen Services

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

Ruft die Details eines bestimmten Fachmanns ab.

Pfad-Parameter

Parameter	Typ	Beschreibung
`id`	integer	ID des Fachmanns

Antwort (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/

Ruft den Arbeitsplan eines Fachmanns ab.

Antwort (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"}
                ]
            }
            // ... restliche Tage
        ],
        "excepciones": [
            {
                "fecha": "2024-01-15",
                "motivo": "Día libre",
                "trabaja": false
            }
        ]
    }
}