{"openapi":"3.1.0","info":{"title":"API du Catéchisme de l'Église catholique","version":"1.0.0","description":"API publique en lecture seule, sans clé ni authentification. Les champs documentés sont stables : de nouveaux champs peuvent s'ajouter, aucun n'est retiré ni renommé."},"servers":[{"url":"https://catechismecatholique.fr"}],"paths":{"/api/cec/{number}":{"get":{"summary":"Un paragraphe du Catéchisme, de 1 à 2865, avec son contexte et ses renvois.","parameters":[{"name":"number","in":"path","required":true,"description":"Numéro de paragraphe, 1 à 2865.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"Blocs d'étude à joindre, séparés par des virgules. Valeurs : cited_by, themes, sources, liturgy, compendium, en_bref, bible, cdse, denzinger, ai. « all » développe les 9 blocs hors « ai ». Au plus 8 blocs nommés explicitement.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : paragraph_out_of_range, unknown_include, too_many_blocks.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/cec":{"get":{"summary":"Plusieurs paragraphes en une requête, par liste ou par plage.","parameters":[{"name":"numbers","in":"query","required":false,"description":"Liste, par exemple 1,2,3.","schema":{"type":"string"}},{"name":"range","in":"query","required":false,"description":"Plage inclusive, par exemple 10-25.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"Blocs d'étude à joindre, séparés par des virgules. Valeurs : cited_by, themes, sources, liturgy, compendium, en_bref, bible, cdse, denzinger, ai. « all » développe les 9 blocs hors « ai ». Au plus 8 blocs nommés explicitement.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : paragraph_out_of_range, too_many_paragraphs, unknown_include, too_many_blocks.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/search":{"get":{"summary":"Recherche plein texte sur le Catéchisme, le Compendium et la doctrine sociale.","parameters":[{"name":"q","in":"query","required":true,"description":"Requête, 2 caractères au minimum.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"}}}},"/api/bible/{book}/{chapter}":{"get":{"summary":"Paragraphes du Catéchisme citant un chapitre biblique, détaillés par verset.","parameters":[{"name":"book","in":"path","required":true,"description":"Slug français (jean) ou code USFX (JHN).","schema":{"type":"string"}},{"name":"chapter","in":"path","required":true,"description":"Numéro de chapitre.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"« texts » joint le texte de chaque paragraphe cité, au plus 50. Seule valeur acceptée.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : unknown_book, bad_reference, unknown_include.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/bible/{book}/{chapter}/{verse}":{"get":{"summary":"Paragraphes du Catéchisme citant un verset précis.","parameters":[{"name":"book","in":"path","required":true,"description":"Slug français (jean) ou code USFX (JHN).","schema":{"type":"string"}},{"name":"chapter","in":"path","required":true,"description":"Numéro de chapitre.","schema":{"type":"string"}},{"name":"verse","in":"path","required":true,"description":"Numéro de verset.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"« texts » joint le texte de chaque paragraphe cité, au plus 50. Seule valeur acceptée.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : unknown_book, bad_reference, unknown_include.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/liturgie/{date}":{"get":{"summary":"Célébration du jour et paragraphes du Catéchisme proposés à la méditation avec les lectures.","parameters":[{"name":"date","in":"path","required":true,"description":"Date AAAA-MM-JJ, ou « today ».","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : bad_date.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/pericope":{"get":{"summary":"Paragraphes du Catéchisme citant un péricope, par référence liturgique. Plusieurs références par requête.","parameters":[{"name":"ref","in":"query","required":true,"description":"Référence, par exemple « Lc 7, 11-16 ». Répétable, ou plusieurs séparées par un point-virgule. Au plus 50.","schema":{"type":"string"}},{"name":"include","in":"query","required":false,"description":"« texts » joint le texte de chaque paragraphe cité, au plus 50. Seule valeur acceptée.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : bad_reference, too_many_refs, unknown_include.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/themes":{"get":{"summary":"Vocabulaire thématique complet, avec le nombre de paragraphes par thème.","parameters":[],"responses":{"200":{"description":"Succès"}}}},"/api/themes/{slug}":{"get":{"summary":"Paragraphes portant un thème donné.","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug du thème, partagé avec le glossaire.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : unknown_slug.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/structure":{"get":{"summary":"Arborescence complète du Catéchisme : parties, sections, chapitres, articles.","parameters":[{"name":"depth","in":"query","required":false,"description":"1 parties, 2 sections, 3 chapitres. Absent : tout.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"}}}},"/api/glossary":{"get":{"summary":"Liste des entrées du glossaire, groupées par grappe thématique.","parameters":[],"responses":{"200":{"description":"Succès"}}}},"/api/glossary/{slug}":{"get":{"summary":"Une entrée du glossaire.","parameters":[{"name":"slug","in":"path","required":true,"description":"Slug de l’entrée, partagé avec les thèmes.","schema":{"type":"string"}}],"responses":{"200":{"description":"Succès"},"400":{"description":"Requête invalide. Codes possibles : unknown_slug.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}},"404":{"description":"Ressource introuvable.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Message lisible, en français."},"code":{"type":"string","description":"Code stable, à tester par le client."}}}}}}}}},"/api/openapi.json":{"get":{"summary":"Ce document OpenAPI.","parameters":[],"responses":{"200":{"description":"Succès"}}}}}}