Vistaire for developers and agents

What is public

Public endpoints are read-only and need no key. Back-office APIs (restaurants, menus, QR codes) are reserved for signed-in owners and are not part of the public API.

Endpoints

• GET /api/exchange-rates: exchange rates used to display public menu prices. Optional base (CAD, USD or EUR) and quotes parameters.
• GET /api/public/menu-dishes/{dishId}/photo, /model/glb and /model/usdz: photo or 3D model of a published dish. Answers with a 307 redirect to the signed file.

curl "https://www.vistaire.ca/api/exchange-rates?base=CAD&quotes=USD,EUR"

Errors

Missing dish photos and 3D models answer { "ok": false, "error": "…" } with 404, or 503 when storage is unavailable.

Any unknown path under /api answers a JSON 404 with a machine-readable code and a recovery hint:

{ "ok": false, "error": "API route not found.", "code": "not_found", "hint": "See https://www.vistaire.ca/openapi.json for the public API." }

Authentication

Public endpoints need no authentication. Vistaire does not offer an OAuth server, self-serve API keys or a sandbox yet. For an integration, write to contact@vistaire.ca. Details are published in /auth.md.

Machine-readable resources

• /openapi.json : OpenAPI 3.1 specification of the public API.
• /llms.txt : Vistaire overview for language models (full version: /llms-full.txt).
• /auth.md : agent authentication and registration.
• /.well-known/api-catalog : API catalog (RFC 9727).
• /.well-known/agent-skills/index.json : agent skills, with when to use them.
• /.well-known/mcp/server-card.json : MCP card (no MCP server yet).

Content pages (pricing, guides, product and local pages, this page) also answer in Markdown with the Accept: text/markdown header; their full text is in /llms-full.txt. For a menu project: Book a call