{"openapi":"3.1.0","info":{"title":"L'Auberge Boischatel — API agents","version":"1.0.0","description":"API publique pour assistants IA : informations sur L'Auberge Boischatel (résidence privée pour aînés certifiée RPA à Boischatel, Québec) et demande de visite. Toujours demander le consentement explicite de la personne avant d’envoyer une demande de visite.","contact":{"name":"L'Auberge Boischatel","email":"contact@aubergeboischatel.com","url":"https://aubergeboischatel.com/agents"}},"servers":[{"url":"https://aubergeboischatel.com"}],"security":[],"paths":{"/api/agent/info":{"get":{"operationId":"getResidenceInfo","summary":"Informations complètes sur la résidence (adresse, services, chambres, visites, tarifs, FAQ)","responses":{"200":{"description":"Profil public de la résidence","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Trop de requêtes"}}}},"/api/agent/faq":{"get":{"operationId":"getFaq","summary":"Questions fréquentes","responses":{"200":{"description":"FAQ","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Trop de requêtes"}}}},"/api/agent/visit-request":{"post":{"operationId":"requestVisit","summary":"Soumettre une demande de visite à la résidence","description":"Envoie la demande à l'équipe, qui rappelle habituellement sous 24 h (au plus 48 h ouvrables). Courriel ou téléphone requis. Confirmer les informations avec la personne et obtenir son consentement avant l'appel.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","consent"],"properties":{"name":{"type":"string","minLength":2,"maxLength":100,"description":"Nom complet de la personne qui souhaite visiter"},"email":{"type":"string","format":"email","description":"Courriel (courriel OU téléphone requis)"},"phone":{"type":"string","description":"Téléphone, ex. 418-555-1234 (courriel OU téléphone requis)"},"preferredDate":{"type":"string","format":"date","description":"Date souhaitée AAAA-MM-JJ, aujourd’hui ou plus tard. Visites du lundi au vendredi."},"preferredTime":{"type":"string","enum":["matin","apres-midi","indifferent"]},"visitFor":{"type":"string","enum":["moi-meme","proche"],"description":"Visite pour soi-même ou pour un proche"},"message":{"type":"string","maxLength":2000,"description":"Besoins, questions, niveau d’autonomie, etc."},"consent":{"type":"boolean","const":true,"description":"Obligatoire (Loi 25) : true uniquement si la personne a explicitement accepté que ses coordonnées soient transmises à L'Auberge Boischatel pour être recontactée."},"source":{"type":"string","maxLength":50,"description":"Assistant utilisé, ex. chatgpt, claude, gemini"}}}}}},"responses":{"200":{"description":"Demande transmise","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"reference":{"type":"string"},"message":{"type":"string"}}}}}},"400":{"description":"Données invalides (voir details)","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}}}}}}}},"415":{"description":"Content-Type application/json requis"},"429":{"description":"Trop de requêtes"},"502":{"description":"Envoi impossible — suggérer d’appeler le 418-822-0347"},"503":{"description":"Service indisponible — suggérer d’appeler le 418-822-0347"}}}}}}