anchor.diff:  
   A Bucketlist is a list of items, activities or goals you want to achieve before you "kick the bucket"
   this is an API to allow you create a new user account, login into your account, create, update, view or delete 
  -bucketlists and bucketlist items.e 
  -
  -## Bucketlists [/bucketlists]
  +bucketlists and bucketlist items.
  +
  +## Registration Resource [/auth/register]
  +Create a new account using a username and password
  +
  +### Create a new account [POST]
  +
  ++ Request (application/json)
  +
  +        {
  +            "username": "john",
  +            "password": "janedoe"
  +        }           
  +
  ++ Response 201 (application/json) 
  +
  +        {
  +            "message": "user registered successfully"
  +            
  +        }
  +        
  +## Login Resource [/auth/login]
  +
  +### Login to your account [POST]
  +
  +Send your account credentials which returns a token for use with requests to the API.
  +
  ++ Request (application/json)
  +
  +        {
  +            "username": "john",
  +            "password": "janedoe"
  +        }           
  +
  ++ Response 200 (application/json) 
  +
  +        {
  +            "token": "The token generated"
  +
  +        }
  +        
  +        
  +        
  +## Bucketlists Resource [/bucketlists]
   
   ### Create New Bucketlist [POST]
   Creates a new bucketlist under your account.
  
positive.code:     + Headers
      
              Authorization: "Your Token"
          
  + Response 201 (application/json) 
  
          [
              {
                  "name": "Dare Devil",
                  "description": "Stunts I want to try out."
              
              }
          ]
  
  ### Get All Bucketlists [GET]
  
  You may create your own question using this action. It takes a JSON
  
negative.code: + Response 200 (application/json)
  
  
  
          [
              {
                  "name": "Dare Devil",
                  "description": "Stunts I want to try out."
              }
          ]
          
  + Response 401 (application/json)
  
          {
              "message": "please login to access your bucketlists"
          }
          
  
  ## Single Bucketlist Resource [/bucketlists/{id}]
  + Parameters
      + id - the bucketlist id
  
  ### Get single bucketlist [GET]
  Gets bucketlist details for the specified id, a user can only access his/her bucketlists only
  
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
              
              
          
  + Response 200 (application/json)
  
              {
                  "name": "Dare Devil",
                  "description": "Stunts I want to try out."
              }
          
          
  + Response 401 (application/json)
  
  
          {
              "message": "please login to access your bucketlists"
          }   
          
          
  ### Update a bucketlist [PUT]
  
  Update bucketlist name or description
  
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
      
      + Body
          
              {
                  "name": "Dare Devil 2",
                  "description": "List of Stunts I want to try out."
              }
              
          
  + Response 200 (application/json)
  
              {
                  "message": "Bucketlist updated successfully"
              }
          
          
  + Response 401 (application/json)
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  + Response 409 (application/json)
  
          {
              "message": "Bucketlist with a similar name exists"
          }
  
  
  ### Delete a bucketlist [DELETE]
  
  Delete bucketlist
  
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
      
          
  + Response 200 (application/json)
  
              {
                  "message": "Bucketlist deleted successfully"
              }
          
          
  + Response 401 (application/json)
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  + Response 404 (application/json)
  
          {
              "message": "Bucketlist not found"
          }
  
  
  ## Bucketlist Items Resource [/bucketlists/{bucketlist_id}/items/]
  
  + Parameters
      + bucketlist_id - the id for any of the bucketlist you created earlier
  
  ### create new item [POST]
  Gets bucketlist items, to get items only just pass the *bucketlist_id* parameter and leave the *item_id* parameter blank
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
              
      + Body
      
              {
                  "name": "climb Mt.Kilimanjaro"
              }
          
  + Response 201 (application/json)
  
              {
                  "message": "Item created successfully"
              }
          
          
  + Response 401 (application/json)
  
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  + Response 409 (application/json)
  
  
          {
              "message": "Item with similar name already exists"
          }   
          
          
  ### Get all items [GET]
  Gets bucketlist items, to get items only just pass the *bucketlist_id* parameter and leave the *item_id* parameter blank
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
              
              
          
  + Response 200 (application/json)
  
              {
                  "name": "Dare Devil",
                  "description": "Stunts I want to try out."
              }
          
          
  + Response 401 (application/json)
  
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  ## Single Bucketlist Item Resource [/bucketlists/{bucketlist_id}/items/{item_id}]
  
  + Parameters
      + bucketlist_id - the id for any of the bucketlist you created earlier
      + item_id - the id for any of the items created earlier
  
  ### Update an item [PUT]
  
  Update bucketlist name or description
  
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
      
      + Body
          
              {
                  "name": "Dare Devil 2",
                  "description": "List of Stunts I want to try out."
              }
              
          
  + Response 200 (application/json)
  
              {
                  "message": "Bucketlist updated successfully"
              }
          
          
  + Response 401 (application/json)
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  + Response 409 (application/json)
  
          {
              "message": "Bucketlist with a similar name exists"
          }
  
  
  ### Delete a bucketlist [DELETE]
  
  Delete bucketlist
  
  + Request (application/json)
  
      + Headers
      
              Authorization: "Your Token"
      
          
  + Response 200 (application/json)
  
              {
                  "message": "Bucketlist deleted successfully"
              }
          
          
  + Response 401 (application/json)
  
          {
              "message": "please login to access your bucketlists"
          }   
          
  + Response 404 (application/json)
  
          {
              "message": "Bucketlist not found"
          }