API - Dienstleistungen | SalonBookIt Developers

GET /api/v1/servicios/

Listet alle aktiven Services des Geschäfts auf.

Query-Parameter

Parameter	Typ	Beschreibung
`categoria_id`	integer	Nach Kategorie filtern
`reservable_online`	boolean	Nur online buchbare Services
`destacado`	boolean	Nur hervorgehobene Services
`lang`	string	Sprache: es, en, ar (Standard: es)

Anfrage-Beispiel

cURL

curl -X GET "https://app.salonbookit.com/api/v1/servicios/?reservable_online=true" \
  -H "X-API-Key: hh_pub_live_abc123..."

Antwort (200 OK)

JSON

{
    "success": true,
    "data": {
        "servicios": [
            {
                "id": 15,
                "nombre": "Corte Clásico",
                "descripcion": "Corte de cabello tradicional con tijera y máquina",
                "duracion_minutos": 30,
                "precio": 25.00,
                "precio_oferta": null,
                "puntos_otorga": 25,
                "puntos_canjea": 250,
                "imagen_url": "https://app.salonbookit.com/media/servicios/corte.jpg",
                "categoria": {
                    "id": 1,
                    "nombre": "Cortes"
                },
                "reservable_online": true,
                "destacado": true,
                "profesionales_ids": [5, 8, 12]
            },
            {
                "id": 16,
                "nombre": "Afeitado Clásico",
                "descripcion": "Afeitado tradicional con navaja y toalla caliente",
                "duracion_minutos": 20,
                "precio": 15.00,
                "precio_oferta": 12.00,
                "puntos_otorga": 15,
                "puntos_canjea": 150,
                "imagen_url": "https://app.salonbookit.com/media/servicios/afeitado.jpg",
                "categoria": {
                    "id": 2,
                    "nombre": "Afeitados"
                },
                "reservable_online": true,
                "destacado": false,
                "profesionales_ids": [5, 8]
            }
        ],
        "total": 12,
        "moneda": "EUR",
        "simbolo_moneda": "€"
    }
}

Antwortfelder

Feld	Typ	Beschreibung
`id`	integer	Eindeutige Service-ID
`nombre`	string	Dienstleistungsname
`descripcion`	string	Detaillierte Beschreibung
`duracion_minutos`	integer	Dauer in Minuten
`precio`	number	Regulärer Preis
`precio_oferta`	number\|null	Rabattpreis (falls zutreffend)
`puntos_otorga`	integer	Gewährte Treuepunkte
`puntos_canjea`	integer	Punkte für kostenlosen Umtausch erforderlich
`profesionales_ids`	array	IDs der Fachleute, die diesen Service anbieten

GET /api/v1/servicios/{id}/

Ruft die Details eines bestimmten Services ab.

Pfad-Parameter

Parameter	Typ	Beschreibung
`id`	integer	Service-ID

Anfrage-Beispiel

cURL

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

Antwort (200 OK)

JSON

{
    "success": true,
    "data": {
        "id": 15,
        "nombre": "Corte Clásico",
        "descripcion": "Corte de cabello tradicional con tijera y máquina. Incluye lavado y peinado.",
        "duracion_minutos": 30,
        "precio": 25.00,
        "precio_oferta": null,
        "puntos_otorga": 25,
        "puntos_canjea": 250,
        "imagen_url": "https://app.salonbookit.com/media/servicios/corte.jpg",
        "galeria": [
            "https://app.salonbookit.com/media/servicios/corte-1.jpg",
            "https://app.salonbookit.com/media/servicios/corte-2.jpg"
        ],
        "categoria": {
            "id": 1,
            "nombre": "Cortes",
            "descripcion": "Todos nuestros servicios de corte de cabello"
        },
        "reservable_online": true,
        "destacado": true,
        "profesionales": [
            {
                "id": 5,
                "nombre": "Carlos García",
                "imagen_url": "https://app.salonbookit.com/media/staff/carlos.jpg"
            },
            {
                "id": 8,
                "nombre": "Miguel López",
                "imagen_url": "https://app.salonbookit.com/media/staff/miguel.jpg"
            }
        ],
        "servicios_relacionados": [
            {
                "id": 16,
                "nombre": "Afeitado Clásico",
                "precio": 15.00
            },
            {
                "id": 20,
                "nombre": "Corte + Barba",
                "precio": 35.00
            }
        ]
    }
}

GET /api/v1/categorias/

Listet die Servicekategorien auf.

Query-Parameter

Parameter	Typ	Beschreibung
`tipo`	string	`servicio` oder `producto`

Antwort (200 OK)

JSON

{
    "success": true,
    "data": {
        "categorias": [
            {
                "id": 1,
                "nombre": "Cortes",
                "descripcion": "Cortes de cabello",
                "imagen_url": null,
                "orden": 1,
                "servicios_count": 5
            },
            {
                "id": 2,
                "nombre": "Afeitados",
                "descripcion": "Afeitados y arreglo de barba",
                "imagen_url": null,
                "orden": 2,
                "servicios_count": 3
            },
            {
                "id": 3,
                "nombre": "Tratamientos",
                "descripcion": "Tratamientos capilares",
                "imagen_url": null,
                "orden": 3,
                "servicios_count": 4
            }
        ]
    }
}