APIs PhotoDeck & intégrations
Connectez vos applications aux bibliothèques de médias et aux sites PhotoDeck, de la gestion des métadonnées et des imports de fichiers à la publication de galeries.
PhotoDeck existe pour vous faire gagner du temps, et cela inclut de l’intégrer avec vos flux de travail et vos environnements.
En bref
- Gérez médias, imports de fichiers, galeries et plus depuis vos propres systèmes.
- API Backend JSON étendue avec OAuth 2.0/2.1, prête pour les agents, spécification OpenAPI.
- L’accès à l’API est inclus dans les abonnements PhotoDeck, dans un usage raisonnable.
Trois façons d’intégrer PhotoDeck
Connecteurs pour chatbots IA
Des connecteurs officiels permettent de piloter un compte PhotoDeck depuis un chatbot IA comme ChatGPT, Claude, Mistral ou Grok, en langage courant et sans développement. En savoir plus ›
API Backend
Pour des applications personnalisées et pour intégrer des comptes PhotoDeck à des environnements métier réels, les développeurs et leurs agents de code s’appuient sur l’API Backend.
Indexation de sites publics
Un frontend externe, par exemple un service d’agrégation de photos, peut lire les médias publiés d’un site PhotoDeck via un index XML.
L’API Backend
Intégrez PhotoDeck à vos systèmes
L’API Backend donne à vos applications un accès direct à votre compte PhotoDeck avec tous les droits de l’utilisateur que vous connectez : bibliothèques de médias, galeries, imports de fichiers, métadonnées…
L’accès est inclus dans les abonnements PhotoDeck, dans le cadre de l’utilisation normale et raisonnable du compte et de son niveau d’abonnement (voir Utilisation acceptable). Contactez-nous pour discuter de votre projet !
Pensée pour les développeurs, prête pour les agents
Le nécessaire pour votre premier appel API
La documentation de l’API Backend couvre le service en profondeur et est conçue pour facilitier le travail des développeurs comme de leurs agents de code :
- Authentification standard : flux par code d’autorisation OAuth 2.0/2.1 avec PKCE. Les utilisateurs s’identifient dans leur navigateur, pas dans votre application.
- Ressources JSON prévisibles : des conventions cohérentes pour les requêtes, les réponses, les erreurs, la pagination, les redirections et les tâches en arrière-plan.
- Formats optimisés par les agents : en plus du HTML, la documentation est disponible en Markdown et en spécification OpenAPI.
Indexation du contenu public des sites
Alimentez un autre frontend depuis un site PhotoDeck
Le contenu public d’un site PhotoDeck (images, vidéos, documents) peut être exposé sous la forme d’un unique fichier XML, prêt à être intégré à un autre frontend ou site, par exemple un service d’agrégation de photos.
- Le propriétaire du site active l’export et fournit un jeton d’authentification ; des identifiants de connexion ne sont jamais requis.
- Le contenu protégé est exclu : les galeries cachées ou protégées par mot de passe ou par login n’apparaissent jamais dans le fichier.
- Le fichier se met à jour automatiquement ; les clients doivent le récupérer avec des requêtes conditionnelles If-Modified-Since.
FAQ
Faut-il l’API pour automatiser des tâches quotidiennes sur un compte PhotoDeck ?
Non. Des connecteurs officiels permettent à des chatbots comme ChatGPT ou Claude d’agir sur un compte PhotoDeck en langage courant, sans aucun développement. L’API Backend vise la création d’applications et d’intégrations plus poussées.
Que puis-je faire via l’API Backend ?
L’API Backend agit notamment sur les médias, les bibliothèques et les sites d’un compte, de la lecture des métadonnées à l’import de fichiers et à la publication de galeries. Voyez la liste complète des endpoints dans la documentation. Certains endpoints et champs modifiables dépendent du niveau d’abonnement du compte.
L’accès à l’API coûte-t-il un supplément ?
L’accès est inclus dans chaque abonnement PhotoDeck, selon un principe d’usage raisonnable et supervisé par PhotoDeck. La politique « Utilisation acceptable » de la documentation précise ce qui relève d’un usage abusif. Les opérations gourmandes en ressources ou en bande passante, comme celles qui impliquent des transferts de fichiers, peuvent compter dans la limite de microjobs du compte.
Comment s’authentifie-t-on auprès de l’API Backend ?
L’API utilise le flux de code d’autorisation OAuth 2.0/2.1 avec PKCE, puis un jeton d’accès Bearer à chaque requête. L’authentification par mot de passe et les cookies de session ne sont pas pris en charge.
Puis-je utiliser des agents de code IA pour développer avec l’API PhotoDeck ?
Oui. La documentation est publiée en Markdown et en spécification OpenAPI pour aider les agents de code IA à trouver les endpoints pris en charge et à construire une intégration, par exemple pour importer des fichiers, en gérer les métadonnées ou publier des galeries. L’application doit toujours être enregistrée et autorisée via OAuth.
Faut-il une approbation avant de développer sur l’API ?
Non, mais nous vous encourageons à discuter de votre projet avec nous, afin que nous puissions nous assurer que l’intégration convient à l’usage prévu.