Services RPC (server)

De Wiki1000

Sommaire

Introduction

Le serveur Ligne 1000 contient un service REST qui permet d’accéder aux différents services techniques du serveur. Sa fonction première est d’offrir un accès à travers HTTP aux services techniques 1000 et de permettre ainsi une utilisation plus large de ces services.

Le serveur REST 1000 interprète une URI, exécute le service REST concerné et retourne le résultat en XML.

Format d'URL

Les points d’accès aux services REST sont des URL définies à partir de la racine de l’URL du serveur Web. L’URL d’un service REST est définie ainsi :

http://hostname/servicename/server/rpc.l1000/rest/restName.restAction1.restAction2?param1=value1&param2=value2&
HostName Nom DNS de la machine Serveur
ServiceName Nom du service Ligne 1000 sur la machine
restName Nom du service REST à exécuter
restAction1 Nom principal de l’action du service REST à exécuter
restAction2 Nom auxiliaire de l’action du service REST à exécuter ; généralement pas utilisé
Couples « paramètre=valeur » Paramètres de l’action.

L’appelant doit exécuter une commande HTTP / GET sur l’URL du service. La réponse d’un service REST est un flux XML dont la structure et le contenu vari suivant le service.

Authentification

Il existe différent modes d'authentification suivant l'usage du service :

Aucun Le service ne requière pas d’authentification.
Anonyme Le service requière une authentification, si celle-ci n’est pas fournie dans les paramètres de l’appel une session anonyme, rattachée à l’utilisateur du serveur, sera créée.
Authentifié Le service requière une authentification passée en paramètre. L’identifiant de session doit être passé dans un paramètre SID de l'URL ou bien à travers les cookies de session.

Service de session

Le service RPC de session permet de gérer les sessions de l'utilisateur.

Nom Action Authentification Usage
info session Non Vérification de session
info login non Ouverture de session
info logout non Fermeture de session
info configuration non Informations de configuration
info usergroups non Retourne les groupes d'un utilisateur pour un dossier
info getcontext oui Retourne les informations sur le contexte utilisateur
info setcontext oui Modifie le contexte utilisateur
info themes non Informations sur les thèmes

Développement DSM

Développement DSM

Outils personnels