Annexe C. Accès API de RHN
Afin de fournir une meilleure flexibilité aux clients, RHN offre une interface de programmation d'applications (API, de l'anglais application programming interface). Cette interface se trouve en cliquant sur Help (aide) en haut à droite du site web de RHN, puis en cliquant sur API dans la barre de navigation de gauche. Vous pouvez également vous rendre directement à l'adresse suivante : https://rhn.redhat.com/rpc/api/. Vous devriez utiliser cet URL pour votre serveur XMLRPC, ainsi que votre navigateur.
L'API de RHN est basée sur XML-RPC, qui permet à des parties séparées de logiciels sur des systèmes séparés d'effectuer des appels de procédure à distance à l'aide de XML sur HTTP. Pour cette raison, tous les appels que vous effectuez doivent suivre les contraintes de XML-RPC. De plus amples informations se trouvent à l'adresse suivante http://www.xmlrpc.com/.
Cette section évite une liste de classes et de méthodes en faveur d'astuces sur l'utilisation effective d'API. Celles-ci incluent des étapes pour déterminer les valeurs requises et un script qui effectue certains des appels.
C.1. Utilisation de la classe auth et obtention de la session Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
Cela vaut la peine de noter que vous utiliserez presque invariablement la classe auth en premier. Cette classe offre une seule méthode, login. Utilisez-la pour établir une session RHN. Trois paramètres sont requis : username (nom d'utilisateur), password (mot de passe) et duration (durée). Les deux premiers proviennent directement de votre compte RHN, alors que le troisième est la durée de la session en secondes, généralement 1200. Une chaîne de session sera retournée qui peut être utilisée dans toutes les autres méthodes.