You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
72 lines
1.9 KiB
72 lines
1.9 KiB
11 years ago
|
Voting
|
||
|
|
=======
|
||
|
|
|
||
|
|
A typical voting/check results flow would be:
|
||
|
|
|
||
|
|
1. Get the token:
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
POST /token/
|
||
|
|
{ "user": "username", "password": "userPassword" }
|
||
|
|
|
||
|
|
Remember: the token is valid for a whole day. You can still request the
|
||
|
|
token, but the response will always be the same for the whole day.
|
||
|
|
|
||
|
|
We suggest keeping the user credentials and token stored somewhere. If any
|
||
|
|
request you receive a
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
HTTP/1.1 404 Not Found
|
||
|
|
Content-Type: text/json
|
||
|
|
|
||
|
|
{ "status": "ERROR",
|
||
|
|
"code": "UserNotFound",
|
||
|
|
"User not found (via token)" }
|
||
|
|
|
||
|
|
then request a new token.
|
||
|
|
|
||
|
|
2. Once you have the token, you can request the user groups (or store then and
|
||
|
|
offer a "Refresh" button somewhere):
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
GET /group/
|
||
|
|
|
||
|
|
This will return all groups in which the user is a member.
|
||
|
|
|
||
|
|
3. For each group, you can request the current voting results:
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
GET /vote/{group_id}/
|
||
|
|
|
||
|
|
4. The first result with *always* be the place with more points. The avoid
|
||
|
|
requesting the places just to show the name, the name for each place will
|
||
|
|
be returned in the results.
|
||
|
|
|
||
|
|
Keep in mind that once every member of a group voted, the voting will have
|
||
|
|
a `closed` property set to `true`. In this case, it means there will be no
|
||
|
|
change in the results and the place has been picked.
|
||
|
|
|
||
|
|
5. To vote, you'll need to display the current places for the group. For that,
|
||
|
|
request the places for the group:
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
GET /group/{group_id}/places/
|
||
|
|
|
||
|
|
Then let the user pick up to 3 places, with ordering.
|
||
|
|
|
||
|
|
6. Once the user picks the places, cast the vote:
|
||
|
|
|
||
|
|
.. sourcecode:: http
|
||
|
|
|
||
|
|
POST /vote/{group_id}/
|
||
|
|
|
||
|
|
{ "choices": [ <first place id>, <second place id>, ... ] }
|
||
|
|
|
||
|
|
7. Once you get a success response, return to the list of groups. You can even
|
||
|
|
re-request the current results, just to be sure.
|