X-Git-Url: http://git.euphorik.ch/index.cgi?a=blobdiff_plain;f=doc%2Fprotocole3.txt;h=c3c2e6af86947583ade712f43ab3658d7ccfd136;hb=ccb7fdfe9914f47cc38f96e5973851f2c6f0c4b6;hp=4cf6255794a1fd6b68ca0a5ea1f6c24f8f7875c5;hpb=e9cb067c980b39000466cbf7c950f6d012c0d1bf;p=euphorik.git

diff --git a/doc/protocole3.txt b/doc/protocole3.txt
index 4cf6255..c3c2e6a 100644
--- a/doc/protocole3.txt
+++ b/doc/protocole3.txt
@@ -2,16 +2,14 @@ Euphorik - Protocole v3
 -----------------------
 
 A. Introduction
----------------
-
+---------------
 Ce document a pour but de décrire la communication client-serveur du site euphorik.
 Les messages échangés sont basés sur le format JSON.
 Ce document remplace 'protocole2.txt'.
 
 
-B. Principe
------------
-
+B. Principes
+------------
 Enregistrement:
  * 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.
 
@@ -22,14 +20,27 @@ Authentification:
 Rafraichissement:
  * Le client envoie une demande au serveur avec l'id du dernier message (via XMLHttpRequest ou un function de JQuery)
  * Le serveur maintient la connexion bloquée si le client est à jour.
- * Dès qu'un nouveau message arrive, le serveur débloque la connexion est envoie le ou les messages manquants.
+ * Dès qu'un nouveau message arrive, le serveur débloque la connexion et envoie le ou les messages manquants.
  
 
 C. Protocole
 ------------
 c : client
 s : server
-Les messages client vers serveur sont envoyé par HTTP-POST
+Les messages client vers serveur sont envoyés par HTTP-POST.
+
+A toutes les requêtes le serveur peut répondre une erreur :
+<error>
+   {
+      "reply" : "error",
+      "error_message" : "blabla"
+   }
+   
+Message ok générique :
+<ok>
+   {
+      "reply" : "ok"
+   }
 
 
 C.1. Login
@@ -57,7 +68,7 @@ ou
 s -> c
    {
       "reply" : "login",
-      "status" : "registration_ok" | "authentification_ok" | "error",
+      "status" : "registration_ok" | "authentification_ok",
       "cookie" : "LKJDLAKSJBFLKASN",
       "id" : 193,
       "pseudo" : "Paul",
@@ -67,11 +78,10 @@ s -> c
       "main_page" : 1,
       "conversations" : [
          {
-            "racine" : 123,
+            "root" : 123,
             "page" : 1
          }
-      ],
-      "error_message" : "blabla"
+      ]
    }
  
  
@@ -86,7 +96,6 @@ c -> s
  
 C.3. Profile
 ------------
-Modification du profile, seul "cookie" est obligatoire.
 
 c -> s
    {
@@ -97,20 +106,19 @@ c -> s
       "pseudo" : "Paul",
       "email" : "paul@pierre.com",
       "css" : "css/3/euphorik.css",
-      "mainPage" : "1",
+      "main_page" : 1,
       "conversations" : [
          {
-            "racine" : "4F",
+            "root" : 123,
             "page" : 1
          }
-      ],
-   }      
+      ]
+   }
       
-s -> c
-   {
-      "reply" : "ok" | "error",
-      "error_message" : "blabla"
-   }
+s -> c
+   <ok>
+ou
+   <error>
 
 
 C.4. Wait event
@@ -123,7 +131,14 @@ c -> s
       "action" : "wait_event",
       "cookie" : "LKJDLAKSJBFLKASN",
       "message_count" : 10,
-      "last_message_id" : 163
+      "last_message_id" : 163,
+      "main_page" : 1,
+      "conversations" : [
+         {
+            "root" : 123,
+            "page" : 1
+         }
+      ]
    }
  
 s -> c
@@ -161,9 +176,26 @@ ou
       "reply" : "error",
       "error_message" : "blabla"
    }
+
+
+C.5. Envoie troll
+-------------------
+
+c -> s
+   {
+      "action" : "put_troll",
+      "cookie" : "LKJDLAKSJBFLKASN",
+      "content" : "Un bon troll velu !"
+   }
+ 
+s -> c
+   {
+      "reply" : "ok" | "error",
+      "error_message" : "blabla"
+   }
+   
 
-
-C.5. Envoie message
+C.6. Envoie message
 -------------------
 Le client envoie un message, le message peut répondre à un certain nombre d'autres messages.
 "answer_to" n'est pas obligatoire.
@@ -174,6 +206,7 @@ c -> s
       "cookie" : "LKJDLAKSJBFLKASN",
       "nick" : "Paul",
       "content" : "Bonjour",
+      "Troll" : 45,
       "answer_to" : [ 345, 532, ... ]
    }
  
@@ -184,7 +217,7 @@ s -> c
    }
  
  
-C.6 Ajout d'une correction d'un messages
+C.7. Ajout d'une correction d'un messages
 ----------------------------------------
 Le client envoie un correctif sous la forme de texte supplémentaire à appondre au dernier messages.
 Le message est appondu avec un " +++ " devant, par exemple :