{"openapi":"3.1.0","info":{"title":"Génial, ma messe ! — API","version":"1.0.0","description":"Horaires des messes catholiques en France : ~45 000 lieux de culte et ~150 000 célébrations à venir (60 jours), resynchronisés chaque nuit depuis messes.info (base officielle de la Conférence des évêques de France). API en lecture seule, sans authentification, CORS ouvert. Heures locales France (Europe/Paris). Un serveur MCP (Model Context Protocol, transport Streamable HTTP) expose les mêmes données avec géocodage intégré sur https://genial-ma-messe.fr/api/mcp (outils find_masses et get_church). Mode d'emploi agents : https://genial-ma-messe.fr/llms.txt","contact":{"url":"https://genial-ma-messe.fr"}},"servers":[{"url":"https://genial-ma-messe.fr"}],"paths":{"/api/masses":{"get":{"operationId":"findMasses","summary":"Églises avec célébrations correspondantes dans une zone géographique","description":"Renvoie un GeoJSON FeatureCollection des églises ayant au moins une célébration au filtre demandé, triées par distance si lat/lng sont fournis. Limité à 400 églises.","parameters":[{"name":"date","in":"query","required":true,"description":"Jour recherché (fuseau Europe/Paris)","schema":{"type":"string","format":"date","example":"2026-07-26"}},{"name":"bbox","in":"query","required":true,"description":"Zone de recherche : minLng,minLat,maxLng,maxLat (WGS84)","schema":{"type":"string","example":"-1.75,48.05,-1.60,48.16"}},{"name":"slot","in":"query","description":"Créneau horaire : morning (5h-12h), afternoon (12h-18h), evening (18h-24h)","schema":{"type":"string","enum":["all","morning","afternoon","evening"],"default":"all"}},{"name":"kind","in":"query","description":"Type : sunday (messe dominicale), week (messe en semaine), other (offices, vêpres…)","schema":{"type":"string","enum":["all","sunday","week","other"],"default":"all"}},{"name":"trad","in":"query","description":"1 : uniquement les célébrations selon le missel de 1962 (forme tridentine)","schema":{"type":"string","enum":["1"]}},{"name":"lat","in":"query","description":"Latitude du point de référence pour le tri par distance","schema":{"type":"number","example":48.117}},{"name":"lng","in":"query","description":"Longitude du point de référence pour le tri par distance","schema":{"type":"number","example":-1.678}}],"responses":{"200":{"description":"GeoJSON FeatureCollection des églises correspondantes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChurchFeatureCollection"}}}},"400":{"description":"Paramètre date ou bbox invalide","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/church/{slug}":{"get":{"operationId":"getChurch","summary":"Fiche complète d'une église","description":"Adresse, paroisse, site web et toutes les célébrations à venir (60 jours) groupées par date. Le slug est renvoyé par /api/masses.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","example":"75-paris-01-saint-germain-l-auxerrois"}}],"responses":{"200":{"description":"Fiche de l'église","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChurchDetail"}}}},"404":{"description":"Église introuvable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Celebration":{"type":"object","description":"Une célébration (heure locale Europe/Paris)","properties":{"time":{"type":["string","null"],"description":"Heure HH:MM, null si inconnue","example":"10:30"},"timeType":{"type":["string","null"],"description":"SUNDAYMASS, WEEKMASS, CELEBRATION, HOURSLITURGY…","example":"SUNDAYMASS"},"lang":{"type":["string","null"],"description":"Langue si autre que le français"},"tags":{"type":"array","items":{"type":"string"}},"comment":{"type":["string","null"]}}},"ChurchFeatureCollection":{"type":"object","properties":{"type":{"type":"string","const":"FeatureCollection"},"features":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"Feature"},"geometry":{"type":"object","properties":{"type":{"type":"string","const":"Point"},"coordinates":{"type":"array","description":"[lng, lat]","items":{"type":"number"}}}},"properties":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"],"example":"église"},"address":{"type":["string","null"]},"zipcode":{"type":["string","null"]},"city":{"type":"string"},"picture":{"type":["string","null"],"format":"uri"},"lat":{"type":"number"},"lng":{"type":"number"},"distanceKm":{"type":["number","null"],"description":"Renseigné si lat/lng fournis"},"celebrations":{"type":"array","items":{"$ref":"#/components/schemas/Celebration"}}}}}}}}},"ChurchDetail":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"type":{"type":["string","null"]},"communityName":{"type":["string","null"],"description":"Paroisse ou communauté"},"communityType":{"type":["string","null"]},"address":{"type":["string","null"]},"zipcode":{"type":["string","null"]},"city":{"type":"string"},"picture":{"type":["string","null"],"format":"uri"},"website":{"type":["string","null"],"format":"uri"},"lat":{"type":"number"},"lng":{"type":"number"},"sourceUpdated":{"type":["string","null"],"description":"Dernière mise à jour de la fiche source"},"days":{"type":"array","description":"Célébrations à venir (60 jours), groupées par date croissante","items":{"type":"object","properties":{"date":{"type":"string","format":"date"},"celebrations":{"type":"array","items":{"$ref":"#/components/schemas/Celebration"}}}}}}}}}}