ADD affichage des ip bannies sur la page d'admin (pas fini, manque bouton "debannir")
[euphorik.git] / doc / protocole3.txt
1 Euphorik - Protocole v3
2 -----------------------
3
4 == Introduction ==
5 Ce document a pour but de décrire la communication client-serveur du site euphorik.\r
6 Les messages échangés sont basés sur le format JSON.
7 Ce document remplace 'protocole2.txt'.
8 \r
9
10 == Principes ==
11 Enregistrement:\r
12  * Permet de créer un compte, un cookie est donné en retour. Ce cookie doit être stocké par le client pour pouvoir s'authentifier par la suite.
13
14 Authentification:\r
15  * L'authentification (login) se fait soit par un couple <login, mot de passe> soit à l'aide d'un cookie.\r
16  * Permet de récupérer les données d'un profile
17
18 Rafraichissement:
19  * Le client envoie une demande au serveur avec l'id du dernier message (via XMLHttpRequest ou un function de JQuery)
20  * Le serveur maintient la connexion bloquée si le client est à jour.
21  * Dès qu'un nouveau message arrive, le serveur débloque la connexion et envoie le ou les messages manquants.
22  
23
24 == Protocole ==
25 c : client
26 s : server
27 Les messages client vers serveur sont envoyés par HTTP-POST.
28
29 A toutes les requêtes le serveur peut répondre une erreur :
30 <error>
31    {
32       "reply" : "error",
33       "error_message" : "blabla"
34    }
35    
36 Message ok générique :
37 <ok>
38    {
39       "reply" : "ok"
40    }
41
42
43 === Enregistrement et authentification ===
44 Permet de créer un nouvel utilisateur.
45 "login" et "password" peuvent ne pas être fournis avec un message de type "register", dans ce cas l'utilisateur ne pourra s'authentifier qu'a l'aide de son cookie.
46 Le mot de passe est hashé en md5.
47
48 c -> s
49    { 
50       "action" : "authentification",
51       "login" : "paul",
52       "password" : "IJKJDHHSAD9081238"
53    }
54 ou
55    {
56       "action" : "authentification",
57       "cookie" : "LKJDLAKSJBFLKASN"
58    }
59 ou
60    {
61       "action" : "register",
62       "login" : "paul",
63       "password" : "IJKJDHHSAD9081238"
64    }
65    
66 s -> c
67    {
68       "reply" : "register" | "authentification",
69       "status" : "auth_not_registered",
70       "cookie" : "LKJDLAKSJBFLKASN",
71       "id" : 193,
72       "css" : "css/1/euphorik.css",
73       "main_page" : 1
74    }
75 ou\r
76    {
77       "reply" : "register" | "authentification",\r
78       "status" : "auth_registered",\r
79       "cookie" : "LKJDLAKSJBFLKASN",\r
80       "id" : 193,\r
81       "nick" : "Paul",\r
82       "login" : "paul49",\r
83       "email" : "paul@pierre.com",\r
84       "css" : "css/3/euphorik.css",
85       "nick_format" : "nick" | "login" | "nick_login",\r
86       "main_page" : 1,
87       "conversations" : [
88          {
89             "racine" : 123,
90             "page" : 1
91          }
92       ],
93       "ek_master" : true | false\r
94    }
95  \r
96  
97 === Logout ===
98 c -> s\r
99    {\r
100       "action" : "logout",\r
101       "cookie" : "LKJDLAKSJBFLKASN"\r
102    }
103  \r
104  
105 === Profile ===
106 c -> s\r
107    {\r
108       "action" : "set_profile",\r
109       "cookie" : "LKJDLAKSJBFLKASN",\r
110       "login" : "paul49",\r
111       "password" : "IJKJDHHSAD9081238",\r
112       "nick" : "Paul",\r
113       "email" : "paul@pierre.com",\r
114       "css" : "css/3/euphorik.css",
115       "nick_format" : "nick" | "login" | "nick_login",\r
116       "main_page" : 1,
117       "conversations" : [
118          {
119             "root" : 123,
120             "page" : 1
121          }
122       ]\r
123    }\r
124       
125 s -> c
126    <ok>
127 ou
128    <error>
129
130
131 === Wait event (page = chat) ===
132 Si "last_message_id" est absent alors le client ne possède pas de message.
133 Si "main_page" est absent alors est vaut 1.
134 "cookie" n'est pas obligatoire.
135
136 c -> s\r
137    {\r
138       "action" : "wait_event",
139       "page" : "chat"\r
140       "cookie" : "LKJDLAKSJBFLKASN",\r
141       "message_count" : 10,
142       "last_message_id" : 163,
143       "main_page" : 1,
144       "troll_id" : 45,
145       "conversations" : [
146          {
147             "racine" : 123,
148             "page" : 1,
149             "last_message_id" : 4 (pas obligatoire)
150          }
151       ]\r
152    }
153  
154 s -> c\r
155 La première conversation est la principale (main).\r
156 L'ordre des conversation est le même que celui des données de l'utilisateur.\r
157 Le format de la date n'est pas formel.\r
158    {\r
159       "reply" : "new_message",\r
160       "conversations" : [\r
161          {\r
162             "last_page" : true | false,\r
163             "messages" : [
164                {\r
165                   "id" : 54,
166                   "user_id" : 344,\r
167                   "date" : "Hier 17:26:54",\r
168                   "system" : true | false,\r
169                   "owner" : true | false,\r
170                   "answered" : true | false,\r
171                   "is_a_reply" : true | false,\r
172                   "nick" : "Paul",\r
173                   "login" : "paul_22",\r
174                   "content" : "Salut",\r
175                   "answer_to" : [\r
176                      { "id" : 123, "nick" : "Pierre", "login" : "pierre_45" }\r
177                   ]
178                   "ek_master" : true | false
179                }\r
180             ]\r
181          }
182          ...\r
183       ]\r
184    }
185 ou\r
186    {\r
187       "reply" : "message_updated",\r
188       "message_id" : 123,\r
189       "content" : "Salut +++ poulpe"\r
190    }
191 ou
192    {
193       "reply" : "new_troll",
194       "troll_id" : 123,
195       "content" : "Linux sera desktop ready en 2008 ?"
196    }
197 ou
198    <error>
199
200
201 === Wait event (page = admin) ===
202 c -> s
203    {
204       "action" : "wait_event",
205       "page" : "admin",
206       "last_troll" : 5
207    }
208    
209 s -> c
210    {
211       "reply" : "troll_modified",
212       "troll_id" : 3,
213       "content" : "plop"
214    }
215 ou
216 s -> c
217    {
218       "reply" : "troll_added",
219       "trolls" :
220          [
221             {
222                "troll_id" : 5,
223                "content" : "plop",
224                "author" : "<Pseudo>"
225                "author_id" : 2
226             }
227          ]
228    }
229 ou
230 s -> c
231    {
232       "reply" : "troll_deleted",
233       "troll_id" : 2
234    }
235 \r
236 \r
237 === Envoie d'un troll ===\r
238 c -> s\r
239    {\r
240       "action" : "put_troll",\r
241       "cookie" : "LKJDLAKSJBFLKASN",\r
242       "content" : "Un bon troll velu !"\r
243    }
244  
245 s -> c
246    <ok>
247 ou
248    <error>
249    
250    \r
251 === Modification d'un troll ===
252 c -> s
253    {
254       "action" : "mod_troll",
255       "cookie" : "LKJDLAKSJBFLKASN",
256       "troll_id" : 3,
257       "content" : "Un bon troll velu 2 !"
258    }
259  
260 s -> c
261    <ok>
262 ou
263    <error>
264    
265    \r
266 === Suppression d'un troll ===
267 c -> s
268    {
269       "action" : "del_troll",
270       "cookie" : "LKJDLAKSJBFLKASN",
271       "troll_id" : 3
272    }
273  
274 s -> c
275    <ok>
276 ou
277    <error>
278    
279
280 === Envoie message ===
281 Le client envoie un message, le message peut répondre à un certain nombre d'autres messages.
282 "answer_to" n'est pas obligatoire.\r
283
284 c -> s\r
285    {\r
286       "action" : "put_message",\r
287       "cookie" : "LKJDLAKSJBFLKASN",\r
288       "nick" : "Paul",\r
289       "content" : "Bonjour",\r
290       "answer_to" : [ 345, 532, ... ]\r
291    }
292  
293 s -> c
294    <ok>
295 ou
296    <error>
297
298
299 === Slapage ===
300 c -> s
301    {
302       "action" : "slap",
303       "cookie" :  "LKJDLAKSJBFLKASN",
304       "user_id" : 67,
305       "reason" : "blablabla"
306    }
307    
308 s -> c
309    <ok>
310 ou
311    <error>
312    
313
314 === Bannissement ===
315 c -> s
316    {
317       "action" : "ban",
318       "cookie" : "LKJDLAKSJBFLKASN",
319       "duration" : 15, // en minute
320       "user_id" : 67,
321       "reason" : "blablabla"
322    }
323    
324 s -> c
325    <ok>
326 ou
327    <error>
328    
329    
330 === Liste des ip bannis ===
331 c -> s
332    {
333       "action" : "list_banned_ips",
334       "cookie" : "LKJDLAKSJBFLKASN"
335    }
336
337 s -> c 
338    {
339       "reply" : "list_banned_ips",
340       "list" : [
341          {
342             ip : "192.168.1.2", 
343             remaining_time : "1h23"
344             users : [
345                {
346                   nick : "Pierre" , 
347                   login : "pierre" 
348                }
349             ]
350          }
351       ]
352    }
353    
354
355 === Débannissement ===
356 c -> s
357    {
358       "action" : "unban",
359       "cookie" : "LKJDLAKSJBFLKASN"
360       "ip" : "192.168.1.2"
361    }
362    
363 s -> c
364    <ok>
365 ou
366    <error>
367 \r
368  \r
369 === Ajout d'une correction d'un messages ===\r
370 Le client envoie un correctif sous la forme de texte supplémentaire à appondre au dernier messages.\r
371 Le message est appondu avec un " +++ " devant, par exemple :\r
372 > Gnome c'est mieux que KDE +++ Euh non ok, c'est faux\r
373 \r
374 c -> s\r
375    {\r
376       "action" : "correction",\r
377       "cookie" : "LKJDLAKSJBFLKASN",\r
378       "content" : "Euh non ok, c'est faux"\r
379    }\r
380    \r
381 s -> c\r
382    {\r
383       "reply" : "correction",\r
384       "status" : "ok" | "error",\r
385       "message_error" : "blabla"\r
386    }