Architecture générale des webservices

PMB propose une API qui regroupe des fonctions qui permettent notamment de (liste non exhaustive) :

• Faire des recherches simples et multi-critères

• Récupérer des notices dans différents formats

• Obtenir les disponibilités des exemplaires

• Récupérer les informations d'un emprunteur (adresse, prêts en cours, en retard, réservations)

• Poser des réservations sur des notices

• Ajouter des commentaires et tagger des notices

En un mot, toutes les fonctions nécessaires à une intégration de PMB dans une autre application.

Cette API est appelée Services externes dans PMB. L'administrateur de PMB choisit les fonctions qu'il autorise à utiliser dans l'API.

L'API est une classe PHP qui propose sous forme de méthodes les fonctions de PMB que l'on a autorisé à utiliser. Cette classe est incluse dans des scripts PHP qui peuvent utiliser ces fonctions.

Une fois les services externes définis, PMB propose des webservices qui permettent d'appeler l'API à distance. Ces webservices implémentent des protocoles d'appel à distance de méthodes (Remote Procedure Call).

Deux protocoles sont implémentés : le protocole SOAP ¹ via HTTP et le protocole JSON-RPC² . Ces protocoles déterminent un format de données pour appeler une méthode de l'API, passer des arguments et récupérer une structure de données résultat.

PMB propose d'une API qui est un ensemble de fonctions utilisables dans des scripts PHP externes à PMB. Dans PMB, cette API est appelée Services externes.

PMB utilise les fonctions de cette API pour les exporter comme des méthodes appelables à distance via des protocoles normalisés SOAP et JSON-RPC. Ces protocoles utilisent le protocole HTTP comme protocole de transport, ce sont donc des webservices.