API - Geschäft | SalonBookIt Developers

GET /api/v1/negocio/

Ruft die allgemeinen Geschäftsinformationen ab.

Erforderliche Header

Header	Wert
`X-API-Key`	Ihr API-Schlüssel

Anfrage-Beispiel

cURL

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

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

Antwortfelder

Feld	Typ	Beschreibung
`id`	string	Eindeutige Geschäfts-UUID
`nombre`	string	Handelsname
`descripcion`	string	Geschäftsbeschreibung
`email`	string	Kontakt-E-Mail
`telefono`	string	Telefon im internationalen Format
`direccion`	object	Physische Geschäftsadresse
`coordenadas`	object	Breiten- und Längengrad für Karten
`configuracion`	object	Buchungs- und Zahlungseinstellungen
`estadisticas`	object	Zähler und Bewertungen

GET /api/v1/negocio/horarios/

Ruft die Öffnungszeiten des Geschäfts ab.

Anfrage-Beispiel

cURL

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

Antwort (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
            },
            // ... restliche Tage
            {
                "dia": 7,
                "dia_nombre": "Domingo",
                "abierto": false,
                "apertura": null,
                "cierre": null,
                "descanso_inicio": null,
                "descanso_fin": null
            }
        ],
        "timezone": "Europe/Madrid"
    }
}

Antwortfelder

Feld	Typ	Beschreibung
`dia`	integer	Wochentag (1=Montag, 7=Sonntag)
`dia_nombre`	string	Name des Tages
`abierto`	boolean	Ob das Geschäft an diesem Tag öffnet
`apertura`	string\|null	Öffnungszeit (HH:MM)
`cierre`	string\|null	Schließzeit (HH:MM)
`descanso_inicio`	string\|null	Pausenbeginn (HH:MM)
`descanso_fin`	string\|null	Pausenende (HH:MM)

GET /api/v1/negocio/festivos/

Ruft Feiertage oder besondere Schließtage ab.

Query-Parameter

Parameter	Typ	Beschreibung
`desde`	string	Startdatum (JJJJ-MM-TT). Standard: heute
`hasta`	string	Enddatum (JJJJ-MM-TT). Standard: +3 Monate

Anfrage-Beispiel

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..."

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