Kinglet API

Each function is preceded with @/api/v1@.

h3. Messages

Each function ends with @/sessionid/userid/username@.

example displaying message number 5: 
@GET /api/v1/messages/5/ru8er03jjg3k40vjl09/23/JR@

*[X]* @GET /messages@ - homepage. stream. messages created by or sent to the logged in user.

*[X]* @GET /messages/page/3@ - page three of the stream.

*[X]* @GET /messages/5@ - retrieve message 5.

*[X]* @POST /messages@ - create a new message.

*[X]* @GET /messages/5/replies@ - retrieve all reply messages for message 5.

*[X]*  @POST /messages/5/replies@ - create a reply message to message 5.


h3. Users

*[X]*  @GET /users/JR@ - retrieve user info for user name JR.
or @GET /users/123 - retrieve user info for user id 123.

*[X]*  @POST /users@ - create a new user account.

*[X]*  @GET /users/JR/activate/[user_digest]@ - activate user account

*[X]* @GET /users/JR/logout/[session_id]@ - logout user JR.

@PUT /users/JR@ - update user account for user name JR.

*[X]*  @POST /users/login@ - login user.

@PUT /users/password@ - change password for existing account. user must be logged-in.

@POST /users/password@ - retrieve new password for existing account. user would not be logged in. this would be executed for someone who forgot or lost password.




User actions:
- [x] create account
- [x] activate account
- [x] login
- [x] logout
- change password
- change e-mail
- change profile description
- request new password


 #kinglet - #api - #programming