Sezione 8 di 12

Integrazioni e API

Integri Buqq con il suo POS o con strumenti personalizzati tramite l'API REST esterna.

La sezione Integrazioni fornisce un'API REST esterna per creare integrazioni personalizzate con il suo POS o altri strumenti. Vi acceda da Pannello di controllo → Integrazioni.

La documentazione API completa — schemi degli endpoint, dettagli di autenticazione ed esempi — è disponibile su buqq.online/api-docs.

Le notifiche di prenotazione via Telegram si configurano in Impostazioni → Notifiche. Consulti la sezione Impostazioni di questa guida per i passaggi di configurazione.

ID commerciante#

Il suo ID commerciante è un identificatore univoco per il suo account all'interno della piattaforma Buqq. Viene mostrato nella pagina Integrazioni ed è necessario quando contatta il supporto o utilizza determinati endpoint API.

Chiavi API#

L'API esterna di Buqq le consente di leggere la disponibilità, creare prenotazioni e aggiornare gli stati delle prenotazioni dai propri sistemi. L'accesso all'API richiede una chiave API associata al suo account commerciante.

Generare una chiave

In Pannello di controllo → Integrazioni, scorra fino a "Chiavi API".
Faccia clic su "Genera chiave API".
Copi la chiave e la conservi nelle variabili d'ambiente o nel gestore dei segreti.

Tratti la sua chiave API come una password — non la condivida né la salvi nel controllo di versione. Se sospetta che una chiave sia stata compromessa, la revochi immediatamente e ne generi una nuova.

Visualizzare la chiave corrente

Se ha bisogno di recuperare la chiave esistente, faccia clic su Mostra — la chiave completa viene visualizzata in modo che possa copiarla di nuovo.

Ruotare una chiave

La rotazione sostituisce la chiave corrente con una nuova. La vecchia chiave viene immediatamente invalidata. Aggiorni le integrazioni che utilizzano la vecchia chiave prima di effettuare la rotazione.

Revocare una chiave

La revoca elimina la chiave corrente senza emettere una nuova. Le chiamate API falliranno finché non genera una nuova chiave. Utilizzi la revoca se sospetta che una chiave sia stata compromessa.

Frammenti cURL#

La pagina Integrazioni mostra frammenti cURL pronti all'uso per le operazioni API più comuni. Sostituisca YOUR_API_KEY con la sua chiave effettiva per testare immediatamente.

ESEMPIO — Verifica disponibilità

curl https://buqq.online/api/external/v1/availability \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G -d "date=2025-08-15" -d "party_size=2"

Note POS#

Se sta collegando Buqq a un sistema punto di vendita, l'API esterna supporta la lettura delle prenotazioni confermate di oggi e l'aggiornamento degli stati (es. contrassegnare una prenotazione come checked-in o annullata) dal suo POS. Consulti la documentazione del suo fornitore POS per i passaggi di integrazione specifici, e faccia riferimento alla documentazione API per i dettagli degli endpoint.

GET /api/external/v1/availability: Restituisce le fasce orarie disponibili per una data e una dimensione del gruppo specificate.
GET /api/external/v1/bookings: Elenca le prenotazioni del suo ristorante. Filtra per data.
POST /api/external/v1/bookings: Crea una nuova prenotazione in modo programmatico.
PATCH /api/external/v1/bookings/{id}/status: Aggiorna lo stato di una prenotazione (confirmed, checked_in, cancelled, no_show).