YaCut - сервис для создания коротких ссылок

Описание

YaCut - это сервис, позволяющий создавать короткие ссылки для длинных URL-адресов. Есть возможность автоматической и ручной генерации идентификаторов коротких ссылок.

Технологический стек

• Python 3.9+
• Flask 3.0.2
• SQLAlchemy 2.0+
• SQLite

Установка и запуск

Клонирование репозитория

git clone https://github.com/your-username/yacut.git
cd yacut

Создание и активация виртуального окружения

# Windows
python -m venv venv
venv\Scripts\activate

# Unix/macOS
python3 -m venv venv
source venv/bin/activate

Установка зависимостей

pip install -r requirements.txt

Настройка переменных окружения

Создайте файл .env в корневой директории проекта:

FLASK_APP=yacut
FLASK_ENV=development
DATABASE_URI=sqlite:///db.sqlite3
SECRET_KEY=your-secret-key

Инициализация базы данных

flask db upgrade

Запуск приложения

flask run

API Документация

• Файл спецификации OpenAPI: http://localhost:5000/static/openapi.yml
• Интерактивная документация Swagger доступна по ссылке

Создание короткой ссылки

POST /api/id/

Request:
{
    "url": "https://example.com",
    "custom_id": "example" // опционально
}

Response:
{
    "url": "https://example.com",
    "short_link": "http://hostname/example"
}

Получение оригинальной ссылки

GET /api/id/{short_id}/

Response:
{
    "url": "https://example.com"
}

Контактные данные

• GitHub: @gera1311
• Email: [email protected]
• Березовский Герман Андреевич