FlossyYuri / exchangeapi

Exchange Rate API

An app that allows you to store people and their contacts.
Open API Documentation · Get in touch

About The Project

An RestAPI that allows you to consult currencies exchange rates and manage Currencies, Rate And History.

Built With

• Spring Boot
• Project Lombok
• H2 Database Engine
• ExchangeRate-API
• SpringDoc OpenAPI
• Swagger UI

Getting Started

To get a local copy up and running follow these simple steps:

Prerequisites

Before trying to run the project you should have installed Adopt Open JDK And Maven.

Installation

1. Clone the repo

   git clone https://github.com/FlossyYuri/exchangeapi.git

2. Enter the backend folder

   cd exchangeapi

3. Install maven packages and Build Jar

   mvnw clean install -DskipTests

4. Run Project

   java -jar target/exchangeapi-0.0.1-SNAPSHOT.jar

5. Access API from

   http://localhost:8080

6. Access API Documentation From

   http://localhost:8080/swagger-ui.html

Requirements

• Manage Currencies
  • Currency CRUD
  • Fetch currencies from Exchange Rate API
  • Save Currencies in memory on Start
  • Validate Fields (With custom Error Handling)
• Manage Rates
  • Rate CRUD
  • Fetch USD Exchange rate with all currencies
  • Calculate Exchange rate for other currencies
  • Validate Fields (With custom Error Handling)
• Manage History
  • Register history
  • Find history data by code
• Get exchange rate by Pair of currency codes
• Get the latest Exchange Rates of a currency
• Implement Swagger Documentation

Contact

Émerson Yuri Cuambe - LinkedIn - Email

Project Link: https://exchange-rate-yuri.herokuapp.com/swagger-ui.html/

(back to top)