Memorial Notifier API

An externally usable API for total management of memorials. Application built using Rails 5.0 API Mode

Case Study

Usage

1. Fork and clone the repo: git clone https://github.com/samibirnbaum/Memorial-Notifier-API.git
2. You must have Ruby installed (built using version 2.4.1)
3. Run $ bundle install to download/install the needed dependencies
4. Start the local server: $ rails s and utilise http://localhost:3000
5. Make requests to the API using the guide below.

---

Authentication

This API uses JWT's for authentication.

Every request made to the API will require a valid JWT.

This is expected to be in the request header in a key/value format:

Authorization: Bearer <JWT>

There are however 3 requests that do not require authentication:

• Creating a User (Sign-Up)
• Initial Authentication (Log-In)
• Forgot My Password

---

Users

• Create a user

Method: POST

Path: http://localhost:3000/api/users

Headers: Content-Type: application/json

Body:

{"user":
	{
	"email":"joebloggs@gmail.com",
	"password":"joe123456"
	}
}

Expectations: The email must be valid as it will be needed to reset a users password. The password must be at least 6 characters long. If sign-up is successful the response status will be 201. If unsuccessful the response status will be 422. The user will not be automatically logged-in.

• Log-In

Method: POST

Path: http://localhost:3000/api/users/sign_in

Headers: Content-Type: application/json

Body:

{"user":
	{
	"email":"joebloggs@gmail.com",
	"password":"joe123456"
	}
}

Expectations: If log-in is successful the response status will be 201. You will also receive a JWT in the response header Authorization. If unsuccessful the response status will be 401 and the error will be returned as JSON.

You will need to use this JWT for all requests to the API, it will expire automatically after 1Hour, after which you will have to log-in again to receive another JWT.

• Update a User

Method: PUT

Path: http://localhost:3000/api/users

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Body:

{"user":
	{
	"email":"joebloggs@gmail.com",
	"password":"strongjoe123456",
	"current_password": "joe123456"
	}
}

Expectations: The user needs to provide their current password, and they will be able to change their email and password. If successful response status will be 204. If unsuccessful response status will be 422 with JSON errors in the response body.

• Forgot My Password

Method: POST

Path: http://localhost:3000/api/reset_password

Headers: Content-Type: application/json

Body:

{"user":
	{
	"email":"joebloggs@gmail.com"
	}
}

Expectations: If successful response status will be 200. The response body will contain a JSON message that an email has been sent to the user. The user will receive an email with a new password that they can log-in with. The expectation is that once logged-in they will then change their password to something more memorable. If unsuccessful response status will be 422 with JSON error message in the response body.

---

---

Memorial Notices

• Create a Memorial Notice

Method: POST

Path: http://localhost:3000/api/memorial_notices

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Body:

{"memorial_notice":
	{
	"first_name":"danny",
	"last_name":"aaa",
	"date_of_death": "01/01/2015",
	"after_nightfall": true,
	"spouse": "Manny Smith",
	"child1": "jermain",
	"child2": "mickey",
	"grandchild1": "max"
	}
}

Note: You can add up to 10 children and grandchildren. Those not added, their value will automatically default to null

Expectations: Requires JWT for authentication, received in response header after log-in. If creation is successful the response status will be 201. If unsuccessful the response status will be 422. Newly created data returned as JSON.

• Get all Memorial Notices

Method: GET

Path: http://localhost:3000/api/memorial_notices

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Expectations: All the memorial notices will be returned in alphabetical order. If request is successful the response status will be 200.

• Show an individual memorial notice

Method: GET

Path: http://localhost:3000/api/memorial_notices/:id

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Expectations: :id in the URL should be the id of a Memorial Notice. This can be viewed in creation response or get all response. If request is successful the response status will be 200. Data returned as JSON.

• Update a Memorial Notice

Method: PUT

Path: http://localhost:3000/api/memorial_notices/:id

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Body:

{"memorial_notice":
	{
	"first_name":"danny",
	"last_name":"aaa",
	"date_of_death": "21/01/2015",
	"after_nightfall": false,
	"spouse": "Jesse Smith",
	"child1": "jermain",
	"child2": "mickey",
	"grandchild1": "max"
	}
}

Note: When you create a Memorial Notice, if you dont add a child or grandchild attribute it will automatically default to null However, when updating the model, anything you leave out will just remain the way it is, so to make a child into null that attribute has to be actively updated to make that change.

Expectations: Requires JWT for authentication, received in response header after log-in. :id in the URL should be the id of a Memorial Notice. This can be viewed in creation response or get all response. If creation is successful the response status will be 201. If unsuccessful the response status will be 422. The new updated data will be returned as JSON.

• Delete a Memorial Notice

Method: DELETE

Path: http://localhost:3000/api/memorial_notices/:id

Headers:

Content-Type: application/json

Authorization: Bearer <JWT>

Expectations: :id in the URL should be the id of a Memorial Notice. This can be viewed in creation response or get all response. If request is successful the response status will be 200. The deleted data will be returned as JSON.