Empezar con la API pública
Crea tu cuenta de desarrollador, genera tu clave sk_live_ y haz tu primera llamada a la API de Sanctumel en cinco minutos.
La API pública de Sanctumel permite mostrar los datos públicos de una iglesia en cualquier sitio web o aplicación: perfil, próximos eventos, anuncios y estado del directo. También da acceso a la Biblia en varios idiomas. Es de solo lectura, gratuita, y se usa con una clave API personal.
1. Crear tu cuenta de desarrollador
- Abre developers.sanctumel.com y haz clic en Obtener mi clave API.
- Elige la pestaña Crear una cuenta y rellena tu nombre, email y contraseña.
- Abre el email de verificación recibido y confirma tu dirección. Este paso es obligatorio: es imposible crear una clave con una dirección no verificada.
Nota: la cuenta de desarrollador es independiente de una cuenta de iglesia. Puedes ser desarrollador sin administrar ninguna iglesia.
2. Generar tu clave
- Inicia sesión en la página Mis claves API.
- Dale un nombre a tu clave (por ejemplo « Sitio de la parroquia ») y haz clic en Crear una clave.
- Copia la clave inmediatamente. Empieza por
sk_live_y no volverá a mostrarse nunca: Sanctumel solo conserva una huella criptográfica, como con una contraseña.
Puedes tener hasta 5 claves activas al mismo tiempo (una por sitio o aplicación, es la buena práctica) y revocar cada una en cualquier momento - la revocación es inmediata.
3. Primera llamada
Todas las peticiones se hacen por HTTPS con tu clave en la cabecera Authorization:
curl https://api.sanctumel.com/api/public/v1/churches/mon-eglise \
-H "Authorization: Bearer sk_live_votre_cle"
La respuesta es JSON:
{
"slug": "mon-eglise",
"name": "Mon Église",
"city": "Bruxelles",
"country": "BE",
"language": "fr",
"publicPage": "https://sanctumel.com/p/…"
}
¿Qué iglesias son accesibles?
Únicamente las que han hecho público su perfil. Cada iglesia decide su visibilidad en sus ajustes de Sanctumel; una iglesia no pública devuelve 404 - la API ni siquiera revela su existencia. El slug de una iglesia pública es visible en la dirección de su página Sanctumel.
Límites y errores
| Código | Significado | Qué hacer |
|---|---|---|
401 | Clave ausente, inválida o revocada | Comprueba la cabecera Authorization: Bearer sk_live_… |
404 | Iglesia no encontrada o perfil no público | Comprueba el slug; la iglesia debe haber elegido la visibilidad pública |
405 | Método no permitido | La API es de solo lectura: únicamente GET |
429 | Demasiadas peticiones | Límite: 120 peticiones/minuto por clave - usa caché en tu lado |
Buenas prácticas de seguridad
- No pongas nunca la clave en código visible por el navegador (JavaScript front): llama a la API desde tu servidor y sirve el resultado a tus páginas.
- Una clave por uso: si un sitio se ve comprometido, revoca su clave sin tocar las demás.
- Guarda las respuestas en caché (los eventos no cambian cada segundo): te mantendrás lejos del límite de peticiones.
Para ir más lejos
- Referencia de los endpoints - todos los endpoints, parámetros y respuestas detalladas.