Description
This Challenge is designed to test your abilities building backend web projects in PHP. Show us your best skills and knowledge in good practices and standards.
Assignment
The objective of this challenge is to create a REST API application that the user can use to track the value of stocks in the stock market. The base application presented here uses a simple implementation of Slim Framework
You may use the Stooq API service.
Mandatory Features
- The application must use a SQL database to store users and record logs of past requests. Check out the Slim documentation if you would like to use Eloquent, Doctrine or Atlas.
- The application must be able to authenticate registered users.
The application must have these three endpoints:
- An endpoint to create a new User, storing the email and information to log in later.
- An endpoint to request a stock quote, like this:
GET /stock?q=aapl.us
{
"name": "APPLE",
"symbol": "AAPL.US",
"open": 123.66,
"high": 123.66,
"low": 122.49,
"close": 123
}
The same endpoint must additionally send an email with the same information to the user who requested the quote. To send the email, you may use SwiftMailer with the wrapper included, or use your own implementation.
- An endpoint to retrieve the history of queries made to the API service by that user. The endpoint should return the list of entries saved in the database, showing the latest entries first:
GET /history
[
{"date": "2021-04-01T19:20:30Z", "name": "APPLE", "symbol": "AAPL.US", "open": "123.66", "high": 123.66, "low": 122.49, "close": "123"},
{"date": "2021-03-25T11:10:55Z", "name": "APPLE", "symbol": "AAPL.US", "open": "121.10", "high": 123.66, "low": 122, "close": "122"},
...
]
Bonus features
The following features are optional to implement, but if you do, you'll be ranked higher in our evaluation process.
- Add unit tests for the endpoints.
- Use RabbitMQ to send the email asynchronously.
- Use JWT instead of basic authentication for endpoints.
- Containerize the app.
Considerations
- Focus only on the backend. We will not review any frontend functionality for this project.
- Provide any and all information our evaluators may need. Use seeders instead of SQL dumps if we need any predetermined database information.
- Provide a detailed Readme with instructions on how to install, use, etc.