API - Servicios | SalonBookIt Developers

GET /api/v1/servicios/

Lista todos los servicios activos del negocio.

Query parameters

Parámetro	Tipo	Descripción
`categoria_id`	integer	Filtrar por categoría
`reservable_online`	boolean	Solo servicios reservables online
`destacado`	boolean	Solo servicios destacados
`lang`	string	Idioma: es, en, ar (defecto: es)

Ejemplo de petición

cURL

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

Respuesta (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": "€"
    }
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	integer	ID único del servicio
`nombre`	string	Nombre del servicio
`descripcion`	string	Descripción detallada
`duracion_minutos`	integer	Duración en minutos
`precio`	number	Precio regular
`precio_oferta`	number\|null	Precio con descuento (si aplica)
`puntos_otorga`	integer	Puntos de fidelidad que otorga
`puntos_canjea`	integer	Puntos necesarios para canjear gratis
`profesionales_ids`	array	IDs de profesionales que ofrecen este servicio

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

Obtiene el detalle de un servicio específico.

Path parameters

Parámetro	Tipo	Descripción
`id`	integer	ID del servicio

Ejemplo de petición

cURL

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

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

Lista las categorías de servicios.

Query parameters

Parámetro	Tipo	Descripción
`tipo`	string	`servicio` o `producto`

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