Estándar abierto OAC
Una especificación JSON neutral para datos de restaurantes. Un solo punto de acceso devuelve todo lo que necesitas para mostrar, enrutar o reservar.
Ejemplo rápido
curl https://www.openalacarte.com/api/standard/v1/restaurants/<slug>
Sin autenticación. En caché en el borde durante 5 minutos. CORS abierto — llámalo desde un navegador.
Qué incluye la respuesta
restaurant.*
Identidad, contacto, moneda, dirección con lat/lng, horario de apertura por día, lo que aceptan (reservas / entrega / recogida).
menu.sections[].items[]
El menú activo completo — nombre, descripción, precio, moneda, alérgenos, imagen — agrupado por sección.
spec + fetched
Sobre versionado (`openalacarte.standard/v1`) + marca de tiempo ISO para que las cachés posteriores sepan lo que tienen.
IDs estables
El `slug` del restaurante es el identificador canónico. No rompemos las URL; los slugs renombrados sirven 301.
Versionado
SemVer a nivel de URL. Las adiciones v1.* son retrocompatibles (nuevos campos, nunca eliminados/renombrados). Los cambios incompatibles pasan a /v2/ con un solapamiento de 12 meses.
Las deprecaciones se anuncian en el registro de cambios para desarrolladores de esta página + a través del encabezado de respuesta Deprecation.
Quién lo está usando
El Estándar abierto es consumido por:
- Nuestro propio generador JSON-LD para Google Maps Reserve + Apple Business Connect
- Widgets integrables (/restaurants/[slug]) — misma carga útil, HTML renderizado
- (Futuro) integradores externos — DoorDash, Uber Eats, Tock — cuando quieran datos canónicos de OAC
¿Construyendo sobre esto? Escribe a devs@openalacarte.com y te incluiremos aquí.
¿Por qué estándar «abierto»?
Porque la especificación está documentada + versionada + estable. Nos comprometemos a no romperla. Si escribes código contra /v1/, ese código sigue funcionando — incluso si OAC cambia de rumbo, incluso si nos adquieren.