PhotoDeck-APIs & Integrationen
Verbinden Sie Ihre Anwendungen mit PhotoDeck-Mediatheken und -Websites, von der Verwaltung von Metadaten und Uploads bis zum Veröffentlichen von Galerien.
PhotoDeck hilft Ihnen, Zeit zu sparen, und das schließt die Synchronisation mit Ihren Arbeitsabläufen und Umgebungen ein.
Auf einen Blick
- Medien, Uploads, Galerien und mehr direkt aus Ihren eigenen Systemen verwalten.
- Umfassende Backend-JSON-API mit OAuth 2.0/2.1, agentenbereit, OpenAPI-Spezifikation.
- Der API-Zugang ist in PhotoDeck-Abos enthalten, im Rahmen der fairen Nutzung.
Drei Wege, PhotoDeck zu integrieren
KI-Chatbot-Connector
Offizielle Connector steuern ein PhotoDeck-Konto über einen KI-Chatbot wie ChatGPT, Claude, Mistral oder Grok, in Alltagssprache und ohne Programmierung. Mehr erfahren ›
Backend-API
Für individuelle Anwendungen und um PhotoDeck-Konten an reale Geschäftsumgebungen anzubinden, bauen Entwickler und ihre Coding-Agenten mit der Backend-API.
Öffentliche Website-Inhalte indexieren
Ein externes Frontend, etwa ein Stock-Aggregationsdienst, kann die publizierten Medien einer PhotoDeck-Website über einen XML-Index auslesen.
Die Backend-API
Binden Sie PhotoDeck an Ihre Systeme an
Die Backend-API gibt Ihren Anwendungen direkten Zugriff auf Ihr PhotoDeck-Konto, mit allen Rechten der Benutzer, mit denen Sie sich verbinden, einschließlich Mediatheken, Galerien, Uploads und Metadaten…
Der Zugang ist in PhotoDeck-Abonnements enthalten, im Rahmen der normalen und fairen Nutzung des Kontos und seiner Abo-Stufe (siehe Acceptable Use). kontaktieren Sie uns, um Ihr Projekt zu besprechen!
Entwicklerfreundlich, agentenbereit
Alles für Ihren ersten API-Aufruf
Die Dokumentation zur Backend-API behandelt den Dienst ausführlich und ist so designt, dass sie sowohl Entwicklern als auch ihren KI-Programmierassistenten die Arbeit erleichtert:
- Standardisierte Authentifizierung: OAuth-2.0/2.1-Authorization-Code-Flow mit PKCE. Nutzer melden sich im Browser an, nicht in Ihrer Anwendung.
- Vorhersehbare JSON-Ressourcen: konsistente Konventionen für Anfragen, Antworten, Fehler, Paginierung, Redirects und Hintergrundjobs.
- Für Agenten optimierte Formate: neben HTML ist die Dokumentation als Markdown und als OpenAPI-Spezifikation verfügbar.
Indexierung öffentlicher Website-Inhalte
Betreiben Sie ein anderes Frontend mit einer PhotoDeck-Site
Die öffentlichen Inhalte einer PhotoDeck-Website (Bilder, Videos, Dokumente) können als einzige XML-Datei bereitgestellt und in ein anderes Frontend oder eine andere Website integriert werden, etwa in einen Stock-Aggregationsdienst.
- Der Website-Eigentümer aktiviert den Export und stellt ein Authentifizierungstoken bereit; Login-Daten sind nie erforderlich.
- Geschützte Inhalte sind ausgeschlossen: versteckte sowie passwort- oder login-geschützte Galerien erscheinen nie in der Datei.
- Die Datei aktualisiert sich automatisch; Clients sollten sie mit bedingten If-Modified-Since-Anfragen abrufen.
FAQ
Brauche ich die API, um alltägliche Aufgaben auf einem PhotoDeck-Konto zu automatisieren?
Nein. Offizielle Connector lassen KI-Chatbots wie ChatGPT oder Claude auf einem PhotoDeck-Konto in Alltagssprache arbeiten, ganz ohne Entwicklung. Die Backend-API ist für den Bau von Anwendungen und tieferen Integrationen gedacht.
Was kann ich über die Backend-API tun?
Die Backend-API arbeitet neben anderen Objekte nauf den Medien, Mediatheken und Websites eines Kontos, vom Lesen der Metadaten bis zum Hochladen von Dateien und zum Veröffentlichen von Galerien. Die Endpunkt-Referenz in der Dokumentation ist die vollständige Liste der Endpunkte. Manche Endpunkte und schreibbare Felder hängen von der Abo-Stufe des Kontos ab.
Kostet der API-Zugang etwas extra?
Der Zugang ist in jedem PhotoDeck-Abo enthalten, nach dem Prinzip der fairen Nutzung, die PhotoDeck überwacht. Die Acceptable-Use-Richtlinie der Dokumentation listet, was als Missbrauch gilt. Ressourcen- oder bandwidthintensive Operationen, etwa mit Dateiübertragungen, können auf das Microjobs-Kontingent des Kontos angerechnet werden.
Wie authentifiziere ich mich gegenüber der Backend-API?
Die API nutzt den OAuth-2.0/2.1-Authorization-Code-Flow mit PKCE und danach ein Bearer-Zugriffstoken bei jeder Anfrage. Passwortauthentifizierung und Browser-Session-Cookies werden nicht unterstützt.
Kann ich KI-Coding-Agenten für die Arbeit mit der PhotoDeck-API nutzen?
Ja. Die Dokumentation ist als Markdown und als OpenAPI-Spezifikation veröffentlicht, um KI-Coding-Agenten zu helfen, unterstützte Endpunkte zu finden und eine Integration zu bauen, etwa um Dateien hochzuladen, deren Metadaten zu verwalten oder Galerien zu veröffentlichen. Die Anwendung muss weiterhin registriert und über OAuth autorisiert werden.
Brauche ich eine Freigabe, bevor ich auf der API entwickle?
Nein, aber wir empfehlen Ihnen, Ihr Projekt mit uns zu besprechen, damit wir sicherstellen können, dass die Integration zum vorgesehenen Einsatz passt.