Referência dos endpoints

Todos os endpoints da API pública Sanctumel: igrejas, eventos, anúncios, direto e Bíblia - parâmetros, exemplos e respostas.

2026-07-05

Base: https://api.sanctumel.com. Todos os endpoints de igrejas exigem o cabeçalho Authorization: Bearer sk_live_… (obter uma chave) e devolvem apenas as igrejas com perfil público. Os endpoints da Bíblia são livres (sem chave).

Igrejas

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

Perfil público da igreja.

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

Resposta:

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

Próximos eventos publicados e públicos (50 máx., ordenados por data). Ideal para a página « Agenda » do seu 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"
  }
]

Dica: registrationPage aponta para a bilheteira Sanctumel - uma simples ligação basta para que os seus visitantes se inscrevam.

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

Anúncios públicos da igreja, paginados.

Parâmetro	Tipo	Predefinição	Descrição
`page`	inteiro	0	Número da página
`size`	inteiro	10	Tamanho da página (máx. 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`

Estado do direto (rádio ou vídeo) - perfeito para um selo « 🔴 Em direto » no seu site.

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

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

Biblioteca pública da igreja (livros, PDF à venda ou para consulta). Parâmetros: type (ex. PDF), page, size (máx. 50). Resposta paginada.

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

Loja pública: produtos visíveis na página /p da igreja, com preço (a partir de, se houver variantes) e ligação productPage para a ficha Sanctumel.

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

Álbuns de fotos públicos. Depois GET …/gallery/{albumId}/photos para as fotos de um álbum.

Bíblia (sem chave)

Quatro versões do domínio público: LSG (francês), KJV (inglês), RVR (espanhol), BLIVRE (português), STV - Statenvertaling (neerlandês). O parâmetro lang (fr, en, es, pt, nl) seleciona a versão.

Abreviaturas: vêm de /api/v1/bible/books?lang=… e podem variar consoante o idioma (João = Jn). Utilize sempre as devolvidas por /books.

`GET /api/v1/bible/versions`

Lista das versões disponíveis.

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

Os 66 livros com as suas abreviaturas e números de capítulos.

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

Um capítulo inteiro. Exemplo - João 3 em francês:

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

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

Um intervalo de versículos. Exemplo - João 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`

Pesquisa de texto integral na versão da língua pedida.

Lembretes

Apenas leitura: qualquer método diferente de GET devolve 405.
Débito: 120 pedidos/minuto por chave (429 além disso) - use cache.
Privacidade: a API nunca expõe os membros, as finanças nem os donativos de uma igreja, e apenas as igrejas com perfil público.

Ir mais longe

Começar com a API - conta, chave e primeira chamada.

Precisa de ajuda?

Respostas rápidas e suporte no seu idioma.

Central de ajuda