Démarrer avec l'API publique
Créer votre compte développeur, générer votre clé sk_live_ et faire votre premier appel à l'API Sanctumel en cinq minutes.
L'API publique Sanctumel permet d'afficher les données publiques d'une église sur n'importe quel site ou application : profil, événements à venir, annonces et statut du direct. Elle donne aussi accès à la Bible en plusieurs langues. Elle est en lecture seule, gratuite, et s'utilise avec une clé API personnelle.
1. Créer votre compte développeur
- Ouvrez developers.sanctumel.com et cliquez sur Obtenir ma clé API.
- Choisissez l'onglet Créer un compte, remplissez vos nom, email et mot de passe.
- Ouvrez l'email de vérification reçu et confirmez votre adresse. Cette étape est obligatoire : impossible de créer une clé avec une adresse non vérifiée.
Note : le compte développeur est indépendant d'un compte d'église. Vous pouvez être développeur sans administrer aucune église.
2. Générer votre clé
- Connectez-vous sur la page Mes clés API.
- Donnez un nom à votre clé (par exemple « Site paroisse ») et cliquez sur Créer une clé.
- Copiez la clé immédiatement. Elle commence par
sk_live_et ne sera plus jamais affichée : Sanctumel n'en conserve qu'une empreinte cryptographique, comme pour un mot de passe.
Vous pouvez avoir jusqu'à 5 clés actives en même temps (une par site ou application, c'est la bonne pratique) et révoquer chacune à tout moment - la révocation est immédiate.
3. Premier appel
Toutes les requêtes se font en HTTPS avec votre clé dans l'en-tête Authorization :
curl https://api.sanctumel.com/api/public/v1/churches/mon-eglise \
-H "Authorization: Bearer sk_live_votre_cle"
La réponse est du JSON :
{
"slug": "mon-eglise",
"name": "Mon Église",
"city": "Bruxelles",
"country": "BE",
"language": "fr",
"publicPage": "https://sanctumel.com/p/…"
}
Quelles églises sont accessibles ?
Uniquement celles qui ont rendu leur profil public. Chaque église décide de sa visibilité dans ses réglages Sanctumel ; une église non publique renvoie 404 - l'API ne révèle même pas son existence. Le slug d'une église publique est visible dans l'adresse de sa page Sanctumel.
Limites et erreurs
| Code | Signification | Que faire |
|---|---|---|
401 | Clé absente, invalide ou révoquée | Vérifiez l'en-tête Authorization: Bearer sk_live_… |
404 | Église introuvable ou profil non public | Vérifiez le slug ; l'église doit avoir choisi la visibilité publique |
405 | Méthode non autorisée | L'API est en lecture seule : uniquement GET |
429 | Trop de requêtes | Limite : 120 requêtes/minute par clé - mettez en cache côté client |
Bonnes pratiques de sécurité
- Ne mettez jamais la clé dans du code visible par le navigateur (JavaScript front) : appelez l'API depuis votre serveur et servez le résultat à vos pages.
- Une clé par usage : si un site est compromis, révoquez sa clé sans toucher aux autres.
- Mettez les réponses en cache (les événements ne changent pas toutes les secondes) : vous resterez loin de la limite de débit.
Aller plus loin
- Référence des endpoints - tous les endpoints, paramètres et réponses détaillées.