aboutsummaryrefslogtreecommitdiff
path: root/API.rst
blob: dd67cf18e624f84d94fb9df899b3ef13804c05e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
API documentation for Session Service
=====================================

General information
-------------------

Bus name: ``org.ArcticaProject.RWA``

Object name: ``/RWA``

Methods
-------

start
^^^^^
Start a new remote session and register it in RWA

**Arguments:** none

**Return type:** string (JSON)

**Structure of returned JSON:**

::

    {"id": <pid>, "url": "<url>", "pin": <pin>}


status
^^^^^^
Return the status of a session

.. note::

    This uses the last status version got by the update service in the background.

**Arguments:** pid/id (integer)

**Return type:** string (JSON)


**Structure of returned JSON:**

::

    {"id": <pid>, "status": <status>}

**Possible status options:**

- ``running``: The session is running and ready for connecting.
- ``joined``: The session is running and a the remote connected to the session.

refresh_status
^^^^^^^^^^^^^^
Same as ``status``, but updates status from Django before returning it here.

stop
^^^^
Stop a remote session

**Arguments:** pid/id (integer)

**Return type:** none