API REST

L’API pubblica

Il sito stesso funziona su questa API: JSON su HTTPS sotto /api/v1, descritta da un documento OpenAPI 3.1 generato dal codice. La pagina di documentazione mostra ogni endpoint e permette di provarlo.

Per gli assistenti IA

Il server MCP

Assistenti come Claude possono verificare la disponibilità e prenotare, consultare, modificare o annullare un tavolo per un ospite tramite il Model Context Protocol. Il server è un client della stessa API pubblica, quindi ogni regola del sito vale anche per un assistente.

Endpoint
/mcp
Trasporto
HTTP in streaming (Streamable HTTP)
Autenticazione
Un token bearer rilasciato dal ristorante

Strumenti

get_restaurant_info
Indirizzo, orari, contatti, regole di prenotazione e premi.
get_menu
Il menù in inglese, italiano, spagnolo o francese, con prezzi, calorie, allergeni e avvertenze.
check_availability
Gli orari liberi di una data, con il numero di tavoli disponibili.
book_table
Prenota un tavolo e restituisce il codice di conferma; si può ripetere senza rischi.
lookup_reservation
Mostra una prenotazione dal codice e dall’email con cui è stata fatta.
modify_reservation
Cambia l’orario o il numero di ospiti.
cancel_reservation
Annulla una prenotazione (l’assistente chiede prima conferma all’ospite).
subscribe_newsletter
Iscrive un ospite alla lettera stagionale.

Entrambi funzionano con lo stesso ristorante immaginario di questo sito: le prenotazioni sono solo dimostrative.

Versioni

Che cosa è in funzione

Sito web
6.0.2 · 00237aa
API
verifica in corso…
Server MCP
verifica in corso…
Schema del database
verifica in corso…