Unsere API ist ein RESTful-Dienst, mit dem Sie die katholische Medienbibliothek von Cathopic direkt in Ihre Anwendungen integrieren können. Greifen Sie programmgesteuert auf Tausende von Bildern, Videos und Grafiken zu.
Was Sie tun können
Suchen und durchstöbern Sie unseren vollständigen Katalog
Ressourcen lizenzieren Sie automatisch für Ihre Endnutzer
Herunterladen in mehreren Formaten, optimiert für unterschiedliche Anwendungsfälle
Auf umfangreiche Metadaten zugreifen, einschließlich Tags, Beschreibungen und liturgischer Informationen
REST-Architektur
Aufgebaut nach gängigen REST-Prinzipien:
Basis-URL:
https://api.cathopic.comDatenformat: JSON-Anfragen und -Antworten
Authentifizierung: API-Schlüssel über den
x-api-key-HeaderHTTP-Methode: POST für alle Endpunkte
Vier zentrale Endpunkte
POST /resources - Sucht im Katalog
POST /resource - Ruft Details zu einem bestimmten Element ab
POST /confirm - Lizenziert eine Ressource und gibt Download-URLs zurück
POST /remove - Beendet die Lizenzierung, wenn sie nicht mehr benötigt wird (nur Website)
Umfangreiche Dokumentation
Alles, was Sie brauchen, ist online verfügbar:
Interaktiver API-Referenzleitfaden: api.cathopic.com/docs
Code-Beispiele in mehreren Sprachen
Detaillierte Angaben zu Parametern
Erste Schritte
Kontaktieren Sie unser Team, um API-Zugriff anzufordern
Erstellen Sie Ihren API-Schlüssel in Einstellungen → API
Fügen Sie eine Zahlungsmethode für die nutzungsbasierte Abrechnung hinzu
Beginnen Sie mit dem Aufbau
Sehen Sie sich die anderen Fragen in diesem Abschnitt an, um Details zu Authentifizierung, Abrechnung und bewährten Vorgehensweisen zu erhalten.
API-Lizenzvereinbarung
Alle Nutzungen der API unterliegen unserer API-Lizenzvereinbarung. Wichtige Punkte, die Sie verstehen sollten:
Nur digitale Nutzung: Der Inhalt darf nur in Web- und E-Mail-Umgebungen angezeigt werden
Keine Dateidownloads: Endnutzer können die Originaldateien nicht herunterladen oder exportieren
Untersagte Verwendungen: KI/ML-Training, Druckmaterialien und Offline-Nutzung sind streng verboten
Abrechnung nach Nutzung: Zahlen Sie nur für die tatsächliche Inhaltsnutzung durch Ihre Endnutzer
Mit der Nutzung der API akzeptieren Sie alle Bedingungen der Lizenzvereinbarung
Bevor Sie die API integrieren:
Prüfen Sie die vollständige API-Lizenzvereinbarung
Verstehen Sie die Einschränkungen und Pflichten
Stellen Sie sicher, dass Ihr Anwendungsfall den Anforderungen „nur digital“ entspricht
Planen Sie Ihre Integration so, dass die Nutzung für die Abrechnung genau erfasst wird
Weitere Details finden Sie unter:
Was kann ich mit der API bauen? (enthält detaillierte Einschränkungen)
Wie funktionieren Lizenzen über die API? (vollständige Lizenzdetails)
Wie wird die API-Nutzung abgerechnet? (Erläuterung des Abrechnungsmodells)
