Référence des endpoints

Tous les endpoints de l'API publique Sanctumel : églises, événements, annonces, direct et Bible - paramètres, exemples et réponses.

2026-07-05

Base : https://api.sanctumel.com. Tous les endpoints églises exigent l'en-tête Authorization: Bearer sk_live_… (obtenir une clé) et ne renvoient que les églises au profil public. Les endpoints Bible sont libres (pas de clé).

Églises

`GET /api/public/v1/churches/{slug}`

Profil public de l'église.

curl https://api.sanctumel.com/api/public/v1/churches/mon-eglise \
  -H "Authorization: Bearer sk_live_…"

Réponse :

{
  "slug": "mon-eglise",
  "name": "Mon Église",
  "bio": "…",
  "denomination": "…",
  "logoUrl": "https://…",
  "coverImageUrl": "https://…",
  "city": "Bruxelles",
  "country": "BE",
  "language": "fr",
  "website": "https://…",
  "publicPage": "https://sanctumel.com/p/…"
}

`GET /api/public/v1/churches/{slug}/events`

Événements publiés et publics à venir (50 max, triés par date). Idéal pour la page « Agenda » de votre site.

[
  {
    "name": "Culte de louange",
    "slug": "culte-louange",
    "description": "…",
    "startDate": "2026-07-11T10:00",
    "endDate": "2026-07-11T13:00",
    "location": "Salle principale",
    "coverImageUrl": null,
    "isFree": true,
    "registrationPage": "https://sanctumel.com/events/culte-louange"
  }
]

Astuce : registrationPage pointe vers la billetterie Sanctumel - un simple lien suffit pour que vos visiteurs s'inscrivent.

`GET /api/public/v1/churches/{slug}/posts`

Annonces publiques de l'église, paginées.

Paramètre	Type	Défaut	Description
`page`	entier	0	Numéro de page
`size`	entier	10	Taille de page (max 50)

curl "https://api.sanctumel.com/api/public/v1/churches/mon-eglise/posts?page=0&size=5" \
  -H "Authorization: Bearer sk_live_…"

`GET /api/public/v1/churches/{slug}/live`

Statut du direct (radio ou vidéo) - parfait pour un badge « 🔴 En direct » sur votre site.

{
  "isLive": true,
  "isVideo": true,
  "stationName": "Radio Mon Église",
  "listenPage": "https://sanctumel.com/radio/…"
}

`GET /api/public/v1/churches/{slug}/library`

Bibliothèque publique de l'église (livres, PDF en vente ou consultation). Paramètres : type (ex. PDF), page, size (max 50). Réponse paginée.

`GET /api/public/v1/churches/{slug}/store`

Boutique publique : produits visibles sur la page /p de l'église, avec prix (à partir de, si variantes) et lien productPage vers la fiche Sanctumel.

`GET /api/public/v1/churches/{slug}/gallery`

Albums photo publics. Puis GET …/gallery/{albumId}/photos pour les photos d'un album.

Bible (sans clé)

Cinq versions du domaine public : LSG (français), KJV (anglais), RVR (espagnol), BLIVRE (portugais), STV - Statenvertaling (néerlandais). Le paramètre lang (fr, en, es, pt, nl) sélectionne la version.

Abréviations : elles viennent de /api/v1/bible/books?lang=… et peuvent varier selon la langue (Jean = Jn). Utilisez toujours celles renvoyées par /books.

`GET /api/v1/bible/versions`

Liste des versions disponibles.

`GET /api/v1/bible/books?lang=fr`

Les 66 livres avec leurs abréviations et nombres de chapitres.

`GET /api/v1/bible/{abbr}/{chapter}?lang=fr`

Un chapitre entier. Exemple - Jean 3 en français :

curl "https://api.sanctumel.com/api/v1/bible/Jn/3?lang=fr"

`GET /api/v1/bible/{abbr}/{chapter}/{from}/{to}?lang=fr`

Une plage de versets. Exemple - Jean 3:16-17 :

curl "https://api.sanctumel.com/api/v1/bible/Jn/3/16/17?lang=fr"

`GET /api/v1/bible/search?q=amour&lang=fr`

Recherche plein texte dans la version de la langue demandée.

Rappels

Lecture seule : toute méthode autre que GET renvoie 405.
Débit : 120 requêtes/minute par clé (429 au-delà) - mettez en cache.
Vie privée : l'API n'expose jamais les membres, les finances ni les dons d'une église, et uniquement les églises au profil public.

Aller plus loin

Démarrer avec l'API - compte, clé et premier appel.

Besoin d'aide ?

Réponses rapides et support dans votre langue.

Centre d'aide