Documentation API et agents

Markdown depuis n’importe quelle page

Chaque page publique répond en markdown depuis son URL habituelle si vous le demandez avec un en-tête Accept. Les navigateurs reçoivent du HTML, les agents du markdown, et les deux réponses varient selon Accept pour qu’une cache ne puisse jamais vous servir la mauvaise version.

curl -H 'Accept: text/markdown' https://www.maisonmileend.ca/en/rooms

La même URL, sans site de documentation distinct.

API publique

Disponibilités en direct et prix tout inclus pour un séjour, taxes et frais compris. C'est le seul point d'accès sans authentification que nous publions.

GET https://www.maisonmileend.ca/api/v1/booking/availability?arrival=2026-09-12&departure=2026-09-15&adults=2&children=0

Aucune clé d'API ni authentification. Les dates utilisent le format AAAA-MM-JJ, et le départ doit suivre l'arrivée.

Commencez par /api pour l'index JSON, ou par /.well-known/api-catalog si vous préférez la découverte standard.

Limite : 40 requêtes par 60 secondes et par client. Au-delà, la réponse est 429.

Chaque réponse porte RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset et RateLimit-Policy — pas seulement le refus — pour que vous puissiez vous auto-limiter. Un 429 ajoute Retry-After.

Erreurs

Chaque erreur, y compris une mauvaise URL sous /api, est du JSON dans une seule enveloppe : code, status, message, un hint et des details facultatifs, plus documentation_url. Basez-vous sur code, jamais sur le texte. Il n'y a aucune page d'erreur HTML.

Versionnement et dépréciation

La version majeure est dans le chemin (/api/v1), et chaque réponse porte API-Version. À l'intérieur d'une version majeure, seuls des ajouts sont publiés. Tout changement cassant devient une nouvelle version majeure, et l'ancienne continue de répondre pendant au moins 180 jours avec Deprecation, Sunset et un Link vers la suivante.

Ressources lisibles par machine

• /api/mcp

  Serveur Model Context Protocol — connectez un assistant et appelez les disponibilités et les informations de l'établissement comme outils.

• /api

  Index JSON de l'API publique : points d'accès, limites, codes d'erreur, versionnement.

• /deprecation-policy.md

  Comment l'API est versionnée et comment une mise hors service est annoncée.

• /.well-known/api-catalog

  Catalogue RFC 9727 qui relie la spécification OpenAPI et les instructions pour agents.

• /llms.txt

  Index de ce site pour les modèles de langage, au format llmstxt.org.

• /llms-full.txt

  Toutes les pages publiques du site en markdown, dans un seul fichier.

• /agents.md

  Quand utiliser cet établissement, comment l’interroger et ce qu’il ne peut pas faire.

• /openapi.json

  Description OpenAPI 3.1 du point d’accès public de disponibilité.

• /sitemap.xml

  Toutes les URL indexables, dans les deux langues, avec les alternatives hreflang.

• /robots.txt

  Règles d’exploration et chemins qui exigent une authentification.

Joindre une personne

Tout ce qu'un agent ne peut pas régler — une demande particulière, un groupe, une réservation existante — passe directement par les hôtes.

• +1-514-700-3932
• info@maisonmileend.ca