Endpointreferentie

Alle endpoints van de publieke Sanctumel API: kerken, evenementen, aankondigingen, live en Bijbel - parameters, voorbeelden en antwoorden.

2026-07-05

Basis: https://api.sanctumel.com. Alle kerk-endpoints vereisen de header Authorization: Bearer sk_live_… (een sleutel verkrijgen) en geven alleen kerken met een publiek profiel terug. De Bijbel-endpoints zijn vrij (geen sleutel).

Kerken

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

Publiek profiel van de kerk.

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

Antwoord:

{
  "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`

Aankomende gepubliceerde en publieke evenementen (max. 50, gesorteerd op datum). Ideaal voor de pagina "Agenda" van uw website.

[
  {
    "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"
  }
]

Tip: registrationPage verwijst naar de Sanctumel-ticketverkoop - een eenvoudige link volstaat om uw bezoekers te laten inschrijven.

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

Publieke aankondigingen van de kerk, gepagineerd.

Parameter	Type	Standaard	Beschrijving
`page`	geheel getal	0	Paginanummer
`size`	geheel getal	10	Paginagrootte (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`

Livestatus (radio of video) - perfect voor een badge "🔴 Live" op uw website.

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

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

De publieke bibliotheek van de kerk (boeken, PDF's te koop of ter inzage). Parameters: type (bijv. PDF), page, size (max 50). Gepagineerd antwoord.

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

Publieke winkel: producten zichtbaar op de /p-pagina van de kerk, met prijs (vanaf, bij varianten) en een productPage-link naar de Sanctumel-productpagina.

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

Publieke fotoalbums. Daarna GET …/gallery/{albumId}/photos voor de foto's van een album.

Bijbel (zonder sleutel)

Vier versies uit het publieke domein: LSG (Frans), KJV (Engels), RVR (Spaans), BLIVRE (Portugees), STV - Statenvertaling (Nederlands). De parameter lang (fr, en, es, pt, nl) selecteert de versie.

Afkortingen: ze komen uit /api/v1/bible/books?lang=… en kunnen per taal verschillen (Johannes = Jn). Gebruik altijd die van /books.

`GET /api/v1/bible/versions`

Lijst van beschikbare versies.

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

De 66 boeken met hun afkortingen en aantal hoofdstukken.

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

Een volledig hoofdstuk. Voorbeeld - Johannes 3 in het Frans:

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

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

Een reeks verzen. Voorbeeld - Johannes 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`

Zoeken in de volledige tekst van de versie in de gevraagde taal.

Ter herinnering

Alleen-lezen: elke andere methode dan GET geeft 405 terug.
Snelheidslimiet: 120 verzoeken/minuut per sleutel (429 daarboven) - gebruik caching.
Privacy: de API stelt nooit de leden, financiën of giften van een kerk bloot, en alleen kerken met een publiek profiel.

Verder gaan

Aan de slag met de API - account, sleutel en eerste aanroep.

Hulp nodig?

Snelle antwoorden en ondersteuning in jouw taal.

Helpcentrum