API Documentation - Beach Booking Admin

📚 API Documentation

🔑 Configurazione API Key

Inserisci la tua API Key per testare gli endpoint.

X-API-Key

POST /api/hotel/booking — Crea nuova prenotazione

Crea una nuova prenotazione. Genera un link per la selezione dell'ombrellone.
Stato: 1_pending, Active: 1, Ombrellone: nessuno

🧪 Tester

Request Body

Response

// Clicca "Esegui" per testare

PUT /api/hotel/booking — Aggiorna prenotazione (cambio date/nome)

Aggiorna una prenotazione esistente (cambio date o nome).
Se ha ombrellone: viene svuotato, torna in attesa
Se non ha ombrellone: rimane in attesa
Il link rimane lo stesso e torna utilizzabile.

🧪 Tester

Request Body

Response

// Clicca "Esegui" per testare

PUT /api/hotel/bookingCancel — Cancella prenotazione

Cancella una prenotazione.
Active: 0, Status: 4_cancelled
Ombrellone: svuotato, Link: bloccato

🧪 Tester

Request Body

Response

// Clicca "Esegui" per testare

PUT /api/hotel/bookingReinstate — Ripristina prenotazione cancellata

Ripristina una prenotazione precedentemente cancellata.
Active: 1, Status: 1_pending
Ombrellone: nessuno (svuotato alla cancellazione)
Link: torna utilizzabile

🧪 Tester

Request Body

Response

// Clicca "Esegui" per testare

PUT /api/hotel/bookingInHouse — Modifica prenotazione in-house (cambio date)

Modifica una prenotazione per ospite già in hotel (cambio date).
Se nuova departure_date < vecchia: accorcia soggiorno, mantiene ombrellone
Se nuova departure_date > vecchia: mantiene originale + crea nuova prenotazione con {confirmation_id}_EXT

🧪 Tester

Request Body

Response

// Clicca "Esegui" per testare

GET /api/hotel/booking — Verifica stato prenotazione

Recupera i dettagli di una prenotazione tramite confirmation_id.

🧪 Tester

confirmation_id

Response

// Clicca "Esegui" per testare

GET /api/hotel/bookings — Lista prenotazioni con filtri

Restituisce l'elenco delle prenotazioni con filtri opzionali.
tipo_data: arrivo = data check-in nel range | partenza = data check-out nel range | soggiorno = prenotazioni che toccano il range

🧪 Tester

tipo_data

arrival_date

departure_date

status

active

limit

Response

// Clicca "Esegui" per testare

📦 Struttura Response Standard

{
  "id": 123,
  "hotel_code": "BLUBSV",
  "confirmation_id": "OPERA123456",
  "guest_name": "Rossi",
  "arrival_date": "2026-07-30",
  "departure_date": "2026-08-02",
  "umbrella_code": null,
  "beach_status": "1_pending",
  "beach_price": null,
  "beach_url": "http://localhost:5000/select/abc...",
  "created_at": "2026-07-30 14:30:00",
  "updated_at": "2026-07-30 14:30:00",
  "link_sent_at": null,
  "confirmed_at": null,
  "active": 1
}

📊 Stati Prenotazione (beach_status)

Codice	Descrizione
1_pending	In Attesa — In attesa selezione ombrellone
2_confirmed	Confermata — Ombrellone selezionato
3_expired	Scaduta — Data arrivo passata
4_cancelled	Cancellata — Prenotazione cancellata

⚠️ Codici Errore

HTTP	Descrizione
401	API key mancante o non valida
400	Campo obbligatorio mancante
403	Accesso negato (prenotazione di altro hotel)
404	Prenotazione non trovata
409	Prenotazione già esistente (solo POST)

📝 Note Importanti

departure_date = checkout hotel → nel DB salvato come departure_date - 1 (ultimo giorno spiaggia)
POST crea nuova prenotazione, errore 409 se già esiste
PUT aggiorna prenotazione esistente identificata da confirmation_id
bookingInHouse imposta automaticamente beach_price = 0
Ogni API Key è associata a un singolo hotel/spiaggia