From 08488da09c4f51be982d70e07bc63724fc6ab128 Mon Sep 17 00:00:00 2001
From: Julio Biason <julioandre@cwi.com.br>
Date: Mon, 17 Mar 2014 17:26:51 -0300
Subject: [PATCH] updated group url

---
 apiary.apib | 38 +++++++++++++++-----------------------
 1 file changed, 15 insertions(+), 23 deletions(-)

diff --git a/apiary.apib b/apiary.apib
index b9eef69..a0e7676 100644
--- a/apiary.apib
+++ b/apiary.apib
@@ -106,12 +106,12 @@ Places to have lunch.
 ## Places [/places/]
 
 Retrieve the list of all places the user has access. This is directly tied
-to the Gropu management and will return all the places the user have access
+to the Group management and will return all the places the user have access
 in their groups.
 
 ### Retrieval [GET]
 
-Return the list of all places in the system.
+Return the list of all places in the system that the user have access.
 
 + Resquest (application/json)
 
@@ -214,7 +214,7 @@ Groups are used to combine a group of users and their favorite places. A locatio
 will be considered "selected" when all users in that group have voted (or
 abstain in voting).
 
-## Groups [/groups/]
+## Groups [/groups/{token}/]
 
 Group management. Only users with verified accounts can create new groups. Once
 a group is created, the user becomes the "maintainer" of the group and only this
@@ -225,10 +225,6 @@ group.
 
 Return groups in the system. Only groups in which the user belongs will be returned.
 
-+ Request (application/json)
-
-        { "token": "userToken" }
-
 + Response 200 (application/json)
 
         { "status": "OK", "groups": [{"id": 1, "name": "Group 1"},
@@ -258,7 +254,7 @@ The user will become the maintainer of the group once it is created.
 
         { "status": "ERROR", "error": "Account not verified" }
 
-## Group management [/group/{groupId}/]
+## Group management [/group/{token}/{groupId}/]
 
 Only the maintainer of the group can change the information for the group. As usual,
 only the required fields are necessary. Passing "maintainer" will change the
@@ -271,7 +267,7 @@ maintenance ownership to another user, immediatelly.
 
 + Request (application/json)
 
-        { "token": "userToken", "name": "Group name", "maintainer": "username" }
+        { "name": "Group name", "maintainer": "username" }
 
 + Response 200 (application/json)
 
@@ -293,11 +289,11 @@ maintenance ownership to another user, immediatelly.
 
         { "status": "ERROR", "error": "New maintaner does not exist" }
 
-### Adding members [PUT]
+### Remove group [DELETE]
 
 + Request (application/json)
 
-        { "token": "userToken", "usernames": ["username"] }
+        { "token": "userToken" }
 
 + Response 200 (application/json)
 
@@ -315,11 +311,13 @@ maintenance ownership to another user, immediatelly.
 
         { "status": "ERROR", "error": "Group not found" }
 
-### Remove group [DELETE]
+## Adding other users to the group [/group/{token}/{groupId}/users/]
+
+### Adding members [PUT]
 
 + Request (application/json)
 
-        { "token": "userToken" }
+        { "usernames": ["username"] }
 
 + Response 200 (application/json)
 
@@ -337,7 +335,8 @@ maintenance ownership to another user, immediatelly.
 
         { "status": "ERROR", "error": "Group not found" }
 
-## Users in the group [/group/{groupId}/users/{username}/]
+
+## Users in the group [/group/{token}/{groupId}/users/{username}/]
 
 Manage users in the group. The user (token owner) must be the maintainer of the
 group.
@@ -348,10 +347,6 @@ group.
 
 ### Remove user [DELETE]
 
-+ Request (application/json)
-
-        { "token": "userToken" }
-
 + Response 200 (application/json)
 
         { "status": "OK" }
@@ -373,20 +368,17 @@ group.
         { "status": "ERROR", "error": "User is not a member of this group" }
 
 
-## Places in the group [/group/{groupId}/places/]
+## Places in the group [/group/{token}/{groupId}/places/]
 
 The places the group has already selected as their prefered/nearby places
 for lunching.
 
 + Parameters
     + groupId ... The group ID.
+    + token ... The user token.
 
 ### Retrieve the places for the group [GET]
 
-+ Request (application/json)
-
-        { "token": "userToken" }
-
 + Response 200 (application/json)
 
         { "status": "OK", "places": [ {"id": 1, "name": "Place 1",