Добро пожаловать в веб-сервис для конвертации валют. Этот сервис позволяет быстро и удобно конвертировать валюты, используя актуальные курсы с сервиса exchangeratesapi.io.
Для работы с сервисом необходимо иметь токен от сервиса exchangeratesapi.io.
Клонируйте репозиторий на свой компьютер с помощью следующей команды:
git clone https://github.com/Alvsok/currates.git
В корне проекта создайте файл .env и добавьте в него ваш токен:
ACCESS_KEY=ваш_токен_здесь
Запустите проект, выполнив в терминале следующую команду:
docker-compose up --build -d
После запуска будут автоматически запущены два Docker контейнера: с веб-сервисом на FastAPI и базой данных PostgreSQL. Миграции базы данных произойдут автоматически, при первом запуске также будет загружен справочник валют.
Для загрузки актуальных курсов валют выполните POST-запрос на адрес:
http://0.0.0.0:8000/currency-rate/
Выполните GET-запрос:
http://0.0.0.0:8000/latest-exchange-rate-update/
Для конвертации валют выполните GET-запрос следующего формата:
http://0.0.0.0:8000/convert/?source_code=MZN&target_code=PAB&amount=34.55
где source_code - код валюты для продажи, target_code - код валюты для покупки, amount - сумма валюты для конвертации.
Справочник валют доступен по GET-запросу:
http://0.0.0.0:8000/currencies/
Этот эндпоинт позволяет просматривать, изменять и удалять валюты в базе данных. Подробности смотрите в документации Swagger и ReDoc.