Добро пожаловать в веб-сервис для конвертации валют. Этот сервис позволяет быстро и удобно конвертировать валюты, используя актуальные курсы с сервиса 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.