Project

General

Profile

Htsp » History » Version 9

Andreas Smas, 2009-02-28 16:31

1 1 Andreas Smas
2
3
4
5
6
----
7
8
= Client to Server methods =
9
10 5 Andreas Smas
----
11 1 Andreas Smas
=== getChallenge ===
12
13 7 Andreas Smas
Request a 32 byte challenge used to generate a authentication digest.
14
15
Request message fields:
16
{{{
17
None
18
}}}
19
20
Reply message fields:
21
{{{
22 9 Andreas Smas
challenge        bin  required   32 bytes of random challenge to be used in next authentication request from client.
23 7 Andreas Smas
}}}
24
25
26 5 Andreas Smas
----
27 1 Andreas Smas
=== authenticate ===
28
29 7 Andreas Smas
Request message fields:
30
{{{
31 8 Andreas Smas
username         str  required   Username.
32
digest           bin  required   SHA-1 hash of [password (not including terminating NUL)] + [challenge]
33 7 Andreas Smas
}}}
34
35
Reply message fields:
36
{{{
37 1 Andreas Smas
noaccess         int  optional   Set to '1' if access was denied.
38 9 Andreas Smas
challenge        bin  optional   32 bytes of random challenge to be used in next authentication request from client.
39
                                 Always present if 'noaccess' is set. This is supplied so the client does not have
40
                                 to issue an extra 'getChallenge' request.
41 7 Andreas Smas
}}}
42
43
44 5 Andreas Smas
----
45 1 Andreas Smas
=== setMode ===
46
47 5 Andreas Smas
----
48 1 Andreas Smas
=== getEvent ===
49 6 Andreas Smas
50
----
51 1 Andreas Smas
=== subscribe ===
52 6 Andreas Smas
53
Request subscription to the given channel. A request for a subscription is always successful.
54
When the server is ready to transmit data it will first send a 'subscriptionStart' message.
55 4 Andreas Smas
56
57 1 Andreas Smas
58
Request message fields:
59
{{{
60 8 Andreas Smas
channelId        int  required   ID for channel. 
61
subscriptionId   int  required   Subscription ID. Selected by client. This value is not interpreted by the server in any form. 
62
                                 The value is used from now on in all messages related to the subscription.
63 1 Andreas Smas
}}}
64 6 Andreas Smas
65
Reply message fields:
66
{{{
67
None.
68 4 Andreas Smas
}}}
69 6 Andreas Smas
70 5 Andreas Smas
71 1 Andreas Smas
----
72 5 Andreas Smas
=== unsubscribe ===
73 1 Andreas Smas
74 5 Andreas Smas
Stop a subscription.
75
Attributes
76
{{{
77 8 Andreas Smas
subscriptionId   int  required   Subscription ID.
78 1 Andreas Smas
}}}
79
80 6 Andreas Smas
Reply message fields:
81
{{{
82
None.
83
}}}
84 2 Andreas Smas
85
86
----
87
88
= Server to Client methods =
89
90
=== channelAdd ===
91
92 3 Andreas Smas
Only sent if session is in async mode.
93
94 2 Andreas Smas
=== channelUpdate ===
95
96 3 Andreas Smas
Only sent if session is in async mode.
97
98 2 Andreas Smas
=== channelDelete ===
99
100 3 Andreas Smas
Only sent if session is in async mode.
101
102 2 Andreas Smas
=== tagAdd ===
103
104 3 Andreas Smas
Only sent if session is in async mode.
105
106 2 Andreas Smas
=== tagUpdate ===
107
108 3 Andreas Smas
Only sent if session is in async mode.
109
110 2 Andreas Smas
=== tagDelete ===
111 3 Andreas Smas
112
Only sent if session is in async mode.
113 2 Andreas Smas
114
=== subscriptionStart ===
115
116
=== subscriptionStop ===
117
118
=== subscriptionStatus ===
119
120
=== queueStatus ===