API Piwigo : exploitez toute la puissance de votre photothèque
Découvrez comment l’API Piwigo vous permet d’automatiser vos tâches, de connecter vos outils et d’utiliser Piwigo comme une véritable base de gestion d’images et de vidéos pour des outils numériques tiers.
Qu’est-ce que l’API Piwigo ?
L’API Piwigo est une interface qui permet d’interagir automatiquement avec votre photothèque, sans passer par l’administration web. Concrètement, elle met à disposition la plupart des fonctionnalités disponibles dans Piwigo : importer des fichiers, créer ou modifier des albums, gérer des tags, des utilisateurs, ou encore supprimer des contenus.
La documentation de l’API est disponible sur GitHub. Et pour faciliter la prise en main, Piwigo propose une interface visuelle permettant de tester chaque méthode directement sur vos propres données.
Pour y accéder, il suffit de vous rendre à l’adresse suivante : [monpiwigo.com]/tools/ws.htm, en remplaçant [monpiwigo.com] par l’URL de votre Piwigo.
Une API accessible à tous les utilisateurs
Que vous soyez client de d’un abonnement à l’offre Piwigo Cloud ou utilisateur de Piwigo en auto-hébergement, vous avez accès à l’API sans surcoût.
- Clients Piwigo Cloud : l’API est incluse dans votre abonnement, sans limite de requêtes.
- Utilisateurs self-hosted : comme Piwigo est open source, l’API fait partie intégrante du logiciel et reste totalement ouverte.
Contrairement à d’autres solutions de digital asset management, Piwigo ne facture pas l’usage de son API selon le volume de requêtes.
Pourquoi utiliser l’API Piwigo ?
L’API vous permet d’aller plus loin dans l’utilisation de Piwigo. Parmi les cas d’usage les plus fréquents :
- Automatiser des tâches répétitives : importer automatiquement des milliers d’images ou mettre à jour des métadonnées.
- Connecter Piwigo à vos outils internes : ERP, CMS, PIM, site web, intranet ou applications métier.
- Utiliser Piwigo comme un backend d’images et de vidéos pour une autre plateforme : dans ce cas, l’administration de Piwigo est peu utilisée, car tout se fait via l’API.
Exemples concrets d’utilisation de l’API
Certains clients utilisent Piwigo comme gestionnaire de fichiers numériques (digital asset manager) entièrement ou partiellement piloté par API.
EarthScope / UNAVCO
EarthScope / UNAVCO gère un réseau international de stations géophysiques (GPS / GNSS) pour surveiller les mouvements de la croûte terrestre. Sur leur site web, on peut visualiser sur une carte interactive chaque station est ses informations. Chaque station dispose d’une fiche avec un onglet photo qui est alimenté par API.
- Les fichiers (photos prises sur le terrain) sont uploadés et organisés dans Piwigo.
- Le site front-end interroge l’API pour récupérer les images liées à chaque station géolocalisée.
- Sur la page d’une station, un onglet “Photos” affiche les clichés associés pour cette station.
- En coulisse, le système doit supporter un nombre élevé de requêtes.
Akena Véranda
Akena Véranda (fabricant de vérandas et solutions aluminium) dispose d’un système interne pour la gestion des employés / utilisateurs. Ils souhaitaient que l’accès à la photothèque (Piwigo) depuis leur portail interne soit fluide, sécurisé et synchronisé automatiquement avec leur annuaire interne.
- Un robot (script ou service interne) synchronise les utilisateurs de leur annuaire d’utilisateurs interne avec Piwigo via l’API : création, mise à jour, suppression des comptes.
- Lorsqu’un utilisateur du portail interne ouvre une page avec accès à la photothèque, le système fait un appel API pour générer une clé d’accès ou un token spécifique, qui permet de “matcher” cet utilisateur avec un compte Piwigo (fonctionnant comme un SSO maison).
ZF
ZF est un fabricant de pièces automobiles, avec des exigences fortes en contrôle qualité et traçabilité. Lorsqu’un lot de milliers de pièces est produit, un échantillon (par exemple 12 pièces) est photographié sous tous les angles. Ces images doivent être identifiables, organisées et accessibles rapidement si un problème est détecté ultérieurement.
- Des scripts automatisés prennent en charge tout le flux via l’API : génération des tags (ex. numéro de lot, date, orientation), associer les tags aux images, upload des photos dans le bon album selon la date
- Lorsqu’un incident est signalé, on peut rechercher rapidement toutes les photos d’un lot donné dans la photothèque (recherche par tag, filtre par date, etc.).
Piwigo comme API de gestion des ressources numériques
L’API Piwigo ouvre la voie à des usages avancés, comparables à ceux des solutions propriétaires de gestion d’actifs numériques (Digital Asset Management, ou DAM). Concrètement, votre photothèque peut devenir :
- un moteur centralisé pour gérer vos images et vidéos,
- un système d’alimentation automatique pour vos sites internet ou plateformes e-commerce,
- une photothèque connectée qui s’intègre dans vos applications métier.
Si vous recherchez des équivalents anglophones, Piwigo peut aussi être vu comme une photo management API ou une digital asset management API.
Avec deux avantages majeurs :
- Piwigo est open source : le code est ouvert et documenté, sans verrouillage propriétaire (vendor lock-in) ;
- L’accès à l’API est illimité et inclus : pas de frais cachés ni de facturation par volume de requête.
Conclusion
L’API Piwigo est un outil puissant qui vous permet d’automatiser, de connecter et d’intégrer votre photothèque dans vos propres systèmes. Que vous l’utilisiez comme simple interface pour importer des fichiers depuis d’autres sources, ou comme backend complet pour gérer des millions d’images, elle est incluse dans Piwigo, sans surcoût ni limite.
👉 Pour en savoir plus et tester l’API, consultez la documentation officielle.