Referencia de los endpoints

Todos los endpoints de la API pública de Sanctumel: iglesias, eventos, anuncios, directo y Biblia - parámetros, ejemplos y respuestas.

2026-07-05

Base: https://api.sanctumel.com. Todos los endpoints de iglesias exigen la cabecera Authorization: Bearer sk_live_… (obtener una clave) y solo devuelven las iglesias con perfil público. Los endpoints de la Biblia son libres (sin clave).

Iglesias

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

Perfil público de la iglesia.

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

Respuesta:

{
  "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 y públicos (50 máx., ordenados por fecha). Ideal para la página « Agenda » de tu sitio.

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

Consejo: registrationPage apunta a la taquilla Sanctumel - un simple enlace basta para que tus visitantes se inscriban.

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

Anuncios públicos de la iglesia, paginados.

Parámetro	Tipo	Por defecto	Descripción
`page`	entero	0	Número de página
`size`	entero	10	Tamaño de 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 del directo (radio o vídeo) - perfecto para una insignia « 🔴 En directo » en tu sitio.

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

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

Biblioteca pública de la iglesia (libros, PDF en venta o consulta). Parámetros: type (ej. PDF), page, size (máx. 50). Respuesta paginada.

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

Tienda pública: productos visibles en la página /p de la iglesia, con precio (desde, si hay variantes) y enlace productPage a la ficha Sanctumel.

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

Álbumes de fotos públicos. Luego GET …/gallery/{albumId}/photos para las fotos de un álbum.

Biblia (sin clave)

Cuatro versiones del dominio público: LSG (francés), KJV (inglés), RVR (español), BLIVRE (portugués), STV - Statenvertaling (neerlandés). El parámetro lang (fr, en, es, pt, nl) selecciona la versión.

Abreviaturas: provienen de /api/v1/bible/books?lang=… y pueden variar según el idioma (Juan = Jn). Utilice siempre las devueltas por /books.

`GET /api/v1/bible/versions`

Lista de las versiones disponibles.

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

Los 66 libros con sus abreviaturas y números de capítulos.

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

Un capítulo entero. Ejemplo - Juan 3 en francés:

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

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

Un rango de versículos. Ejemplo - Juan 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`

Búsqueda de texto completo en la versión del idioma solicitado.

Recordatorios

Solo lectura: cualquier método distinto de GET devuelve 405.
Límite de peticiones: 120 peticiones/minuto por clave (429 más allá) - usa caché.
Privacidad: la API nunca expone los miembros, las finanzas ni los donativos de una iglesia, y únicamente las iglesias con perfil público.

Para ir más lejos

Empezar con la API - cuenta, clave y primera llamada.

¿Necesitas ayuda?

Respuestas rápidas y soporte en tu idioma.

Centro de ayuda