User endpoints
==============
    
  .. _login-endpoint:

  .. http:post:: /api/user/login

     :synopsis: Endpoint for login and get a token
     
     :<json string email: Email of the user
     :<json string password: Password of the user
     
     :>json string token: The access token
     
     :statuscode 400: The request was not well structured, some field missing
     :statuscode 401: The credentials doesnt match with any user 
     
     **Example request**
     
     .. sourcecode:: http
     
       POST /api/user/login HTTP/1.1
       
       {
        "email":"admin@mail.com",
        "password":"1234"
       }
     
     
     **Example request**
     
     .. sourcecode:: http
     
      HTTP/1.1 200 OK
      
      {"token":"abcabcabcabc"}
   

  .. http:post:: /api/user/logout

     :synopsis: By calling this endpoint the currently used token is not valid anymore

     :statuscode 200: Logout successful

  .. http:post:: /api/user/register

     :synopsis: Register a new user on the instance. This endpoint will work depending on your
                register policy.

     :<json string email: (required) New user's email
     :<json string password: (required) New user's password

     :statuscode 201: User registered successfully
     :statuscode 400: Request with invalid arguments
     :statuscode 401: Registration disabled 
     :statuscode 409: User already registered
	 
  
  .. http:get:: /api/user/info
    
     :synopsis: Get user data
	 
     :statuscode 200: Successful data retreival
     
     :>json string email: User email
     :>json apiToken[] apiTokens: List of user API tokens
     :>json string apiToken.Name: Name of the API token
     :>json string apiToken.ExpiresOn: Expiration date
     :>json string apiToken.ReadOnly: Read only token
	 
  .. http:post:: /api/user/tokens
   
    :synopsis: Create a API token

    :statuscode 201: Token crated successfully
    :statuscode 400: Mising parameters
	 
    :<json string name: Name of the token
    :<json string expirationTime: expiration date of the token in format like "2006-01-02T15:04:05Z07:00"
    :<json boolean readOnly: set token as read only
	 
  .. http:delete:: /api/user/tokens
   
     :synopsis: Delete a API token
	 
     :statuscode 200: Token deleted
     :statuscode 400: Mising parameter
	 
     :<json string name: Name of the token to delete