API - Commerce | SalonBookIt Developers

GET /api/v1/negocio/

Obtient les informations générales du commerce.

Headers requis

Header	Valeur
`X-API-Key`	Votre clé API

Exemple de requête

cURL

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

Réponse (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
        }
    }
}

Champs de réponse

Champ	Type	Description
`id`	string	UUID unique du commerce
`nombre`	string	Nom commercial
`descripcion`	string	Description du commerce
`email`	string	Email de contact
`telefono`	string	Téléphone au format international
`direccion`	object	Adresse physique du commerce
`coordenadas`	object	Latitude et longitude pour les cartes
`configuracion`	object	Paramètres de réservations et paiements
`estadisticas`	object	Compteurs et évaluations

GET /api/v1/negocio/horarios/

Obtient les horaires d'ouverture du commerce.

Exemple de requête

cURL

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

Réponse (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
            },
            // ... reste des jours
            {
                "dia": 7,
                "dia_nombre": "Domingo",
                "abierto": false,
                "apertura": null,
                "cierre": null,
                "descanso_inicio": null,
                "descanso_fin": null
            }
        ],
        "timezone": "Europe/Madrid"
    }
}

Champs de réponse

Champ	Type	Description
`dia`	integer	Jour de la semaine (1=Lundi, 7=Dimanche)
`dia_nombre`	string	Nom du jour
`abierto`	boolean	Si le commerce ouvre ce jour
`apertura`	string\|null	Heure d'ouverture (HH:MM)
`cierre`	string\|null	Heure de fermeture (HH:MM)
`descanso_inicio`	string\|null	Début de la pause (HH:MM)
`descanso_fin`	string\|null	Fin de la pause (HH:MM)

GET /api/v1/negocio/festivos/

Obtient les jours fériés ou de fermeture spéciale.

Paramètres de requête

Paramètre	Type	Description
`desde`	string	Date de début (AAAA-MM-JJ). Par défaut : aujourd'hui
`hasta`	string	Date fin (YYYY-MM-DD). Défaut : +3 mois

Exemple de requête

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

Réponse (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
            }
        ]
    }
}