The Currency Exchange Service API provides endpoints to retrieve and save currency exchange rates. It interacts with a local Microsoft SQL Server database to store and retrieve currency data. This document outlines the available endpoints and their usage.
GET /currency/{date}/{code} This endpoint retrieves currency exchange rates for a specific date and currency code.
date: The date for which currency exchange rates are requested (format: "YYYY-MM-DD"). code: (Optional) The currency code for which exchange rates are requested. If not provided, exchange rates for all currencies on the specified date are returned.
Request
GET /currency/2024-02-25/USDResponse
[
{
"title": "United States Dollar",
"code": "USD",
"value": 1.00,
"a_date": "2024-02-25"
}
]POST /currency/save/{date}
This endpoint saves currency exchange rates fetched from a public API into the local database.
- date: The date for which currency exchange rates are to be fetched and saved (format: "YYYY-MM-DD"). Request
POST /currency/save/2024-02-25Response
{
"success": true
}The Currency Exchange Service operates as follows:
- When a request is made to save currency exchange rates for a specific date (POST /currency/save/{date}), the service retrieves data from a public API provided by the National Bank.
- The retrieved data is asynchronously saved to the local database in a separate Goroutine. Upon successful saving of the data, a success response is returned to the client without waiting for the database operation to complete.
- If there is an error during the database operation, it is logged, and an error response is returned to the client. This documentation provides an overview of the available endpoints, their usage, and the operation of the Currency Exchange Service.