API - Negocio | SalonBookIt Developers

GET /api/v1/negocio/

Obtiene la información general del negocio.

Headers requeridos

Header	Valor
`X-API-Key`	Tu API Key

Ejemplo de petición

cURL

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

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "id": "uuid-del-tenant",
        "nombre": "Hello Hair Men's Salon",
        "descripcion": "Barbería premium en el centro de Alicante",
        "email": "info@hellohair.com",
        "telefono": "+34612345678",
        "direccion": {
            "calle": "Calle Principal 123",
            "ciudad": "Alicante",
            "codigo_postal": "03001",
            "pais": "ES"
        },
        "coordenadas": {
            "lat": 38.3452,
            "lng": -0.4815
        },
        "logo_url": "https://app.salonbookit.com/media/logos/hellohair.png",
        "imagen_portada_url": "https://app.salonbookit.com/media/portadas/hellohair.jpg",
        "redes_sociales": {
            "instagram": "hellohairalicante",
            "facebook": "hellohairmen",
            "website": "https://hellohair.com"
        },
        "configuracion": {
            "moneda": "EUR",
            "simbolo_moneda": "€",
            "timezone": "Europe/Madrid",
            "idioma_principal": "es",
            "acepta_pagos_online": true,
            "requiere_pago_anticipado": false,
            "tiempo_cancelacion_horas": 24,
            "puntos_activo": true
        },
        "estadisticas": {
            "servicios_count": 12,
            "profesionales_count": 5,
            "valoracion_media": 4.8,
            "total_resenas": 156
        }
    }
}

Campos de respuesta

Campo	Tipo	Descripción
`id`	string	UUID único del negocio
`nombre`	string	Nombre comercial
`descripcion`	string	Descripción del negocio
`email`	string	Email de contacto
`telefono`	string	Teléfono con formato internacional
`direccion`	object	Dirección física del negocio
`coordenadas`	object	Latitud y longitud para mapas
`configuracion`	object	Ajustes de reservas y pagos
`estadisticas`	object	Contadores y valoraciones

GET /api/v1/negocio/horarios/

Obtiene los horarios de apertura del negocio.

Ejemplo de petición

cURL

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

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "horarios": [
            {
                "dia": 1,
                "dia_nombre": "Lunes",
                "abierto": true,
                "apertura": "09:00",
                "cierre": "20:00",
                "descanso_inicio": "14:00",
                "descanso_fin": "16:00"
            },
            {
                "dia": 2,
                "dia_nombre": "Martes",
                "abierto": true,
                "apertura": "09:00",
                "cierre": "20:00",
                "descanso_inicio": null,
                "descanso_fin": null
            },
            // ... resto de días
            {
                "dia": 7,
                "dia_nombre": "Domingo",
                "abierto": false,
                "apertura": null,
                "cierre": null,
                "descanso_inicio": null,
                "descanso_fin": null
            }
        ],
        "timezone": "Europe/Madrid"
    }
}

Campos de respuesta

Campo	Tipo	Descripción
`dia`	integer	Día de la semana (1=Lunes, 7=Domingo)
`dia_nombre`	string	Nombre del día
`abierto`	boolean	Si el negocio abre ese día
`apertura`	string\|null	Hora de apertura (HH:MM)
`cierre`	string\|null	Hora de cierre (HH:MM)
`descanso_inicio`	string\|null	Inicio del descanso (HH:MM)
`descanso_fin`	string\|null	Fin del descanso (HH:MM)

GET /api/v1/negocio/festivos/

Obtiene los días festivos o de cierre especial.

Query parameters

Parámetro	Tipo	Descripción
`desde`	string	Fecha inicio (YYYY-MM-DD). Defecto: hoy
`hasta`	string	Fecha fin (YYYY-MM-DD). Defecto: +3 meses

Ejemplo de petición

cURL

curl -X GET "https://app.salonbookit.com/api/v1/negocio/festivos/?desde=2024-01-01&hasta=2024-12-31" \
  -H "X-API-Key: hh_pub_live_abc123..."

Respuesta (200 OK)

JSON

{
    "success": true,
    "data": {
        "festivos": [
            {
                "fecha": "2024-01-01",
                "motivo": "Año Nuevo",
                "todo_el_dia": true
            },
            {
                "fecha": "2024-01-06",
                "motivo": "Reyes Magos",
                "todo_el_dia": true
            },
            {
                "fecha": "2024-08-15",
                "motivo": "Vacaciones de verano",
                "todo_el_dia": true
            },
            {
                "fecha": "2024-12-25",
                "motivo": "Navidad",
                "todo_el_dia": true
            }
        ]
    }
}