Services RPC (server)
m (a déplacé Services REST (server) vers Services RPC (server)) |
|||
| Ligne 1 : | Ligne 1 : | ||
===Introduction=== | ===Introduction=== | ||
| − | Le serveur Ligne 1000 contient un service | + | Le serveur Ligne 1000 contient un service RPC 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. | 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 | + | Le serveur RPC 1000 interprète une URI, exécute le service RPC concerné et retourne le résultat en XML. |
===Format d'URL=== | ===Format d'URL=== | ||
| − | Les points d’accès aux services | + | Les points d’accès aux services RPC sont des URL définies à partir de la racine de l’URL du serveur Web. |
| − | L’URL d’un service | + | L’URL d’un service RPC est définie ainsi : |
<pre> | <pre> | ||
| Ligne 42 : | Ligne 42 : | ||
L’appelant doit exécuter une commande HTTP / GET sur l’URL du service. | L’appelant doit exécuter une commande HTTP / GET sur l’URL du service. | ||
| − | La réponse d’un service | + | La réponse d’un service RPC est un flux XML ou JSON dont la structure et le contenu varie suivant le service. |
===Aiguillage des requêtes=== | ===Aiguillage des requêtes=== | ||
| Ligne 100 : | Ligne 100 : | ||
{{footer}} | {{footer}} | ||
[[Category:Serveur]] | [[Category:Serveur]] | ||
| + | [[Category:Service RCP]] | ||
Version du 9 octobre 2013 à 08:56
Sommaire |
Introduction
Le serveur Ligne 1000 contient un service RPC 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 RPC 1000 interprète une URI, exécute le service RPC concerné et retourne le résultat en XML.
Format d'URL
Les points d’accès aux services RPC sont des URL définies à partir de la racine de l’URL du serveur Web. L’URL d’un service RPC est définie ainsi :
GET url: http://host/service/server/rpc.l1000?parameters Headers: X-Rpc-Method=service.action Accept: application/xml application/json
| HostName | Nom DNS de la machine Serveur |
| ServiceName | Nom du service Ligne 1000 sur la machine |
| X-Rpc-Method | Champ spécifique de l'entête de requête contenant la méthode à exécuter |
| Accept | Type de contenu accepté |
| Paramètres de l’action. | Couples « paramètre=valeur » |
L’appelant doit exécuter une commande HTTP / GET sur l’URL du service. La réponse d’un service RPC est un flux XML ou JSON dont la structure et le contenu varie suivant le service.
Aiguillage des requêtes
Lorsque le champ X-Rpc-Method n'est pas spécifié, le chemin de l'url est interprété pour déterminer la méthode :
| url action | X-Rpc-Method |
|---|---|
| login.l1000 | design.login |
| action.l1000 | design.action |
| rpc.l1000 | |
| portal.l1000 | url.portal |
| connect.l1000 | url.connect |
| rss.l1000 | rss.<url fragment> |
| sdata.l1000 | sdatajson.execute |
| sdata | sdatajson.execute |
Authentification
Il existe différent modes d'authentification suivant l'usage du service :
| Mode | Usage |
|---|---|
| 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 |
| Whos here now: Members 0 Guests 0 Bots & Crawlers 1 |
