Differences

This shows you the differences between two versions of the page.

--- code:xmlrpc [2008/12/29 22:29] – added link to r2x.h pkubanek
+++ code:xmlrpc [2009/02/20 02:43] – Finished description of authentification pkubanek
@@ Line 10: / Line 10: @@
 As first parameter to every XML-RPC call, you must pass an identification token. It is always a structure, and holds either credentials, or session ID.
-Credentials are passed in structure under //login// and //password// fields. So for example if
+Credentials are passed in structure under //login// and //password// fields. So for example if you are calling rts2.mainstatus, the procedure in Python will be:
+<code python>
+import xmlrpclib
+xmlRpcServer = xmlrpclib.ServerProxy("http://localhost", use_datetime = True)
+res = xmlRpcServer.rts2.mainstatus ({'login': 'myname', 'password': 'test'})
+print res
+</code>
+Session ID can be obtained by rts2.login call. Then it should be passed as session_id parameter to all subsequent calls. Following example demonstrates how to use session_id:
+<code python>
+res = xmlRpcServer.rts2.login ({'login': 'myname', 'password': 'test'})
+sess_id = res['session_id']
+res = xmlRpcServer.rts2.mainstatus ({'session_id' : sess_id})
+print res
+</code>
+Session id's expire after inactivity. The time of inactivity is defined in response field 'expires'. Before session ID expires, you can renew it by making call to rts2.login, with session_id as only parameter.
 ===== Commands =====