Add OpenAPI specification and API documentation

Что сделано:

• Создан файл спецификации OpenAPI (openapi.yaml) с описанием базовых эндпоинтов API
• Добавлена документация по API в формате Swagger
• Уточнены основные требования и методы взаимодействия с сервисом
• Внесены правки в README для ссылки на API документацию