Проект YaMDb собирает отзывы (Review) пользователей на произведения (Title). Сами произведения в YaMDb не хранятся, здесь нельзя посмотреть фильм или послушать музыку.

Произведения делятся на категории, такие как «Книги», «Фильмы», «Музыка». Например, в категории «Книги» могут быть произведения «Винни-Пух и все-все-все» и «Марсианские хроники», а в категории «Музыка» — песня «Давеча» группы «Жуки» и вторая сюита Баха. Список категорий (Category) может быть расширен (например, можно добавить категорию «Изобразительное искусство» или «Ювелирка»).

Произведению может быть присвоен жанр из списка предустановленных (например, «Сказка», «Рок» или «Артхаус»). Новые жанры может создавать только администратор.

Благодарные или возмущённые читатели оставляют к произведениям текстовые отзывы (Review) и выставляют произведению рейтинг (оценку в диапазоне от одного до десяти). Из множества оценок автоматически высчитывается средняя оценка произведения.

Полная документация к API находится по эндпоинту/redoc.

• Python 3.9.,
• Django 3.2.,
• DRF,
• JWT,
• SQLite

git clone [email protected]:Olga-Ustinova/api_yamdb.git

cd api_yamdb

python -m venv venv

source venv/Scripts/activate

python -m pip install --upgrade pip

pip install -r requirements.txt

cd api_yamdb

python manage.py makemigrations

python manage.py migrate

python manage.py runserver

Для неавторизированных пользователей работа с API доступна только в режиме чтения.

1. Пользователь отправляет POST-запрос на добавление нового пользователя с параметрами email и username на эндпоинт /api/v1/auth/signup/. Использовать имя 'me' в качестве username запрещено. Поля email и username должны быть уникальными (например, передав в Body в Postman):

{
    "username": "string", 
    "email": "string" 
}  

2. YaMDB отправляет письмо с кодом подтверждения (confirmation_code) на адрес email.
3. Пользователь отправляет POST-запрос с параметрами username и confirmation_code на эндпоинт /api/v1/auth/token/, в ответе на запрос ему приходит token (JWT-токен) (например, передав в Body в Postman):

{
    "username": "string", 
    "confirmation_code": "string" 
}  

4. При желании пользователь отправляет PATCH-запрос на эндпоинт /api/v1/users/me/ и заполняет поля в своём профайле (описание полей — в документации).

• ✅ Iskander-Haz (в роли Python-разработчика - разработчик 1)
• ✅ CHEDEIV8 (в роли Python-разработчика - разработчик 2)
• ✅ Olga-Ustinova (в роли Python-разработчика Тимлид - разработчик 3)