Desarrolladores

API OpenALaCarte

Una API REST para leer tus reservas, pedidos y menús, crear reservas de servidor a servidor y recibir eventos de webhook firmados en tiempo real. JSON sobre HTTPS, autenticación con clave Bearer, paginación por cursor, marcas de tiempo ISO-8601 UTC.

URL base

https://openalacarte.com/api/v1

Especificación OpenAPI Obtener una clave API

Claves Bearer

Claves con alcance de empresa, mostradas una sola vez al crearlas.

60 req/min

Por clave, con encabezados estándar de límite de tasa.

Webhooks firmados

HMAC-SHA256, al menos una vez, con reintentos.

Inicio rápido

Genera una clave en Claves API y luego lista tus reservas:

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();

Referencia

Autenticación y convenciones

Claves API, límites de tasa, errores, paginación, versionado.

Reservas

Lista y crea reservas en todos tus restaurantes.

Pedidos

Lee pedidos, avanza su estado, emite reembolsos.

Elementos del menú

Sincroniza tu menú completo con un TPV o un agregador.

Webhooks

Eventos firmados en tiempo real con reintentos.

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.