Notre API est un service REST qui vous permet d’intégrer directement la bibliothèque de médias catholiques de Cathopic dans vos applications. Accédez par programmation à des milliers d’images, de vidéos et de graphismes.
Ce que vous pouvez faire
Rechercher et parcourir l’ensemble de notre catalogue
Licencier des ressources pour vos utilisateurs finaux automatiquement
Télécharger dans plusieurs formats optimisés pour différents cas d’usage
Accéder à des métadonnées riches incluant des tags, des descriptions et des informations liturgiques
Architecture REST
Conçue selon des principes REST standard :
URL de base :
https://api.cathopic.comFormat des données : requêtes et réponses JSON
Authentification : clé API via l’en-tête
x-api-keyMéthode HTTP : POST pour tous les endpoints
Quatre endpoints essentiels
POST /resources - Rechercher dans le catalogue
POST /resource - Obtenir les détails d’un élément spécifique
POST /confirm - Licencier une ressource et obtenir des URL de téléchargement
POST /remove - Arrêter la licence lorsque ce n’est plus nécessaire (site web uniquement)
Documentation complète
Tout ce dont vous avez besoin est disponible en ligne :
Référence API interactive : api.cathopic.com/docs
Exemples de code dans plusieurs langages
Spécifications détaillées des paramètres
Commencer
Contactez notre équipe pour demander l’accès à l’API
Générez votre clé API dans Paramètres → API
Ajoutez un moyen de paiement pour la facturation d’utilisation
Démarrez la construction
Consultez les autres questions de cette section pour obtenir des détails sur l’authentification, la facturation et les bonnes pratiques.
Contrat de licence de l’API
Toute utilisation de l’API est soumise à notre Contrat de licence de l’API. Points clés à comprendre :
Usage numérique uniquement : le contenu ne peut être affiché que dans des environnements web et e-mail
Pas de téléchargement de fichiers : les utilisateurs finaux ne peuvent pas télécharger ni exporter les fichiers originaux
Usages interdits : l’entraînement IA/ML, les supports imprimés et l’usage hors ligne sont strictement interdits
Facturation selon l’usage : payez uniquement pour l’utilisation réelle du contenu par vos utilisateurs finaux
En utilisant l’API, vous acceptez toutes les conditions du contrat de licence
Avant d’intégrer l’API :
Consultez l’intégralité du Contrat de licence de l’API
Comprenez les restrictions et les obligations
Assurez-vous que votre cas d’usage respecte les exigences « numérique uniquement »
Planifiez votre intégration pour suivre l’usage avec précision afin de facturer
Pour plus de détails, consultez :
Que puis-je construire avec l’API ? (inclut des restrictions détaillées)
Comment les licences fonctionnent-elles via l’API ? (détails complets sur la licence)
Comment l’utilisation de l’API est-elle facturée ? (explication du modèle de facturation)
