AUTH.

Toutes les requêtes API doivent inclure votre clé API dans l'en-tête HTTP X-API-KEY.

curl -X GET https://carteblanche.rocks/api/v1/restaurants \ -H "X-API-KEY: your_api_key_here"

WEBHOOKS.

Restez informé grâce à des notifications instantanées. Notre moteur de Webhooks envoie des données directement à votre système dès qu'une nouvelle réservation est effectuée ou qu'un statut change.

{ "event": "reservation.created", "timestamp": "2026-05-08T14:30:00Z", "data": { "id": "res_827364", "restaurant": "The Jane", "covers": 2 } }

POINTS D'ENTRÉE

GET /api/v1/restaurants

Uniquement des restaurants des guides Michelin ou Gault&Millau actuels.

[ { "name": "The Jane", "slug": "the-jane", "city": "Antwerp", "stars": 2 }, ... ]
GET /api/v1/availability

Accords en direct de nos chefs. Petite caution de {price} contre les no-shows.

[ { "slug": "the-jane", "date": "2026-05-08", "items": [ { "id": "three-course", "capacity": 4, "time": "19:30" } ] }, ... ]
POST /api/v1/availability

Poussez la disponibilité directement depuis votre système POS ou d'inventaire.

{ "slug": "the-jane", "date": "2026-05-15", "items": [ { "id": "three-course", "capacity": 8, "time": "19:30" } ] }
POST /api/v1/webhooks

Enregistrez une URL pour recevoir des notifications en temps réel pour votre restaurant.

{ "slug": "the-jane", "url": "https://your-system.com/webhooks/cb" }
GET /api/v1/reservations/{id}

Récupérez le statut actuel d'une réservation.

POST /api/v1/reservations

Créez une réservation depuis un système externe. Les convives sont identifiés par e-mail.

{ "slug": "the-jane", "date": "2026-05-15", "combi": "three-course", "email": "guest@carteblanche.rocks", "name": "John Doe", "persons": 2, "phone": "+32...", "notes": "Window seat please" }
PUT /api/v1/reservations/{id}

Mettez à jour une réservation existante (p. ex. modifier les couverts ou la date).

{ "persons": 4, "notes": "Updated: now 4 people" }
DELETE /api/v1/reservations/{id}

Annulez une réservation. Cela libère les couverts.