Vistaire · Développeurs

Vistaire pour les développeurs et les agents

Vistaire est un service de menu digital pour restaurants. Cette page décrit la petite surface publique, en lecture seule, que les développeurs et les agents IA peuvent utiliser sans compte.

Dernière mise à jour : 21 octobre 2026

Ce qui est public

Les points d’accès publics sont en lecture seule et ne demandent aucune clé. Les API du back-office (restaurants, menus, QR) sont réservées aux propriétaires connectés et ne font pas partie de l’API publique.

Points d’accès

GET /api/exchange-rates : taux de change utilisés pour l’affichage des prix d’un menu public. Paramètres facultatifs base (CAD, USD ou EUR) et quotes.
GET /api/public/menu-dishes/{dishId}/photo, /model/glb et /model/usdz : photo ou modèle 3D d’un plat publié. Répond par une redirection 307 vers le fichier signé.

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

Erreurs

Les photos et modèles 3D introuvables répondent { "ok": false, "error": "…" } en 404, ou en 503 si le stockage est indisponible.

Toute route inconnue sous /api répond en JSON 404 avec un code lisible par une machine et une piste de résolution :

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

Authentification

Aucune authentification n’est nécessaire pour les points d’accès publics. Vistaire n’offre pas encore de serveur OAuth, de clés d’API en libre-service ni d’environnement de test. Pour une intégration, écrivez à contact@vistaire.ca. Le détail est publié dans /auth.md.

Ressources lisibles par machine

/openapi.json : spécification OpenAPI 3.1 de l’API publique.
/llms.txt : présentation de Vistaire pour les modèles de langage (version complète : /llms-full.txt).
/auth.md : authentification et inscription des agents.
/.well-known/api-catalog : catalogue d’API (RFC 9727).
/.well-known/agent-skills/index.json : compétences pour agents, avec quand les utiliser.
/.well-known/mcp/server-card.json : fiche MCP (pas de serveur MCP pour l’instant).

Les pages de contenu (tarifs, guides, pages produit et locales, cette page) répondent aussi en Markdown avec l’en-tête Accept: text/markdown ; leur texte complet est dans /llms-full.txt. Pour un projet de menu : Prendre rendez-vous