Développeurs

API OpenALaCarte

Une API REST pour lire vos réservations, commandes et menus, créer des réservations de serveur à serveur et recevoir des événements webhook signés en temps réel. JSON sur HTTPS, authentification par clé Bearer, pagination par curseur, horodatages ISO-8601 UTC.

URL de base

https://openalacarte.com/api/v1

Spécification OpenAPI Obtenir une clé API

Clés Bearer

Clés limitées à l'entreprise, affichées une seule fois à la création.

60 req/min

Par clé, avec des en-têtes de limite de débit standard.

Webhooks signés

HMAC-SHA256, au moins une fois, avec nouvelles tentatives.

Démarrage rapide

Générez une clé dans Clés API, puis listez vos réservations :

cURL

curl https://openalacarte.com/api/v1/bookings \
  -H "Authorization: Bearer oac_live_<your-key>"

JavaScript (fetch)

const res = await fetch("https://openalacarte.com/api/v1/bookings?limit=50", {
  headers: { Authorization: `Bearer ${process.env.OAC_API_KEY}` },
});
const { data, nextCursor } = await res.json();

Référence

Authentification et conventions

Clés API, limites de débit, erreurs, pagination, gestion des versions.

Réservations

Listez et créez des réservations dans tous vos restaurants.

Commandes

Lisez les commandes, faites avancer leur statut, émettez des remboursements.

Articles du menu

Synchronisez l'intégralité de votre menu vers un système de caisse ou un agrégateur.

Webhooks

Événements signés en temps réel avec nouvelles tentatives.

Website & operations

Enquiries

Read and update website contact-form submissions.

Newsletter

List, add and unsubscribe newsletter subscribers.

Reviews

List diner reviews across your restaurants.

Site analytics

Tenant-website traffic: views, top pages, daily series.

Customers

A CRM roll-up of diners built from bookings.

Live (front-of-house)

Today's bookings, covers and next arrivals.

Calendar feed

iCalendar feed of upcoming bookings.

AI-drafted replies to reviews.

Vouchers

Issue, redeem and void operator vouchers. Write endpoints need a company key.

Menu availability

Mark items sold out (86-ing) and set stock.

Availability

Check whether a booking slot can seat a party.

Reports

Revenue, orders and covers per restaurant.

Site pages (headless CMS)

Read, edit and publish your website's pages as raw HTML.

Memberships

Members of your regulars / loyalty plans.

Promo codes

List and create discount codes.

Waitlist

Booking waitlist entries across your restaurants.

Tables & QR

Floor-plan tables with their scan-to-order QR links.