API REST

L’API publique

Le site lui-même repose sur cette API : du JSON en HTTPS sous /api/v1, décrit par un document OpenAPI 3.1 généré à partir du code. La page de documentation présente chaque point d’accès et permet de l’essayer.

Pour les assistants IA

Le serveur MCP

Des assistants comme Claude peuvent vérifier les disponibilités et réserver, consulter, modifier ou annuler une table pour un client grâce au Model Context Protocol. Le serveur est un client de la même API publique : chaque règle du site s’applique aussi à un assistant.

Point d’accès
/mcp
Transport
HTTP en flux (Streamable HTTP)
Authentification
Un jeton bearer délivré par le restaurant

Outils

get_restaurant_info
Adresse, horaires, coordonnées, règles de réservation et distinctions.
get_menu
La carte en anglais, italien, espagnol ou français, avec prix, calories, allergènes et avertissements.
check_availability
Les créneaux libres d’une date, avec le nombre de tables disponibles.
book_table
Réserve une table et renvoie le code de confirmation ; peut être relancé sans risque.
lookup_reservation
Affiche une réservation à partir de son code et de l’e-mail utilisé.
modify_reservation
Modifie l’heure ou le nombre de convives.
cancel_reservation
Annule une réservation (l’assistant demande d’abord confirmation au client).
subscribe_newsletter
Inscrit un client à la lettre de saison.

Les deux fonctionnent avec le même restaurant fictif que ce site : les réservations ne sont que des démonstrations.

Versions

Ce qui tourne

Site web
6.0.2 · 00237aa
API
vérification…
Serveur MCP
vérification…
Schéma de la base de données
vérification…