67 lines
2.8 KiB
Markdown
67 lines
2.8 KiB
Markdown
# 📡 API
|
||
|
||
## Основные эндпоинты
|
||
|
||
___
|
||
|
||
### 👤 Пользователи (Users)
|
||
|
||
- `GET /users` — Получить список всех пользователей
|
||
- `GET /users/{user_id}` — Получить конкретного пользователя
|
||
- `GET /users/{user_id}/tasks` — Получить задачи пользователя
|
||
- **Query параметры:**
|
||
- `limit` (int, опционально) — Максимальное количество задач для возврата
|
||
- `offset` (int, опционально, по умолчанию 0) — Количество задач для пропуска
|
||
- **Пример:** `GET /users/1/tasks?limit=10&offset=20`
|
||
- `POST /users` — Создать нового пользователя
|
||
- `PUT /users/{user_id}` — Обновить данные пользователя
|
||
- `PATCH /users/{user_id}` — Частично обновить данные пользователя
|
||
- `DELETE /users/{user_id}` — Удалить пользователя
|
||
|
||
---
|
||
|
||
### ✅ Задачи (Tasks)
|
||
|
||
- `GET /tasks` — Получить список всех задач
|
||
- `GET /tasks/{task_id}` — Получить задачу по ID
|
||
- `POST /tasks` — Создать новую задачу
|
||
- `PUT /tasks/{task_id}` — Обновить задачу
|
||
- `PATCH /tasks/{task_id}` — Частично обновить задачу
|
||
- `DELETE /tasks/{task_id}` — Удалить задачу
|
||
|
||
---
|
||
|
||
### 📎 Вложения (Attachments)
|
||
|
||
- `GET /tasks/{task_id}/attachments` — Получить все вложения к задаче
|
||
- `GET /attachments/{attach_id}` - Скачать вложение
|
||
- `POST /tasks/{task_id}/attachments` — Добавить вложение к задаче
|
||
- `DELETE /attachments/{attach_id}` — Удалить вложение
|
||
|
||
---
|
||
|
||
### 🏷️ Теги (Tags)
|
||
|
||
- `GET /tags` — Получить список всех тегов
|
||
- `GET /tags/{tag_id}` — Получить тег по ID
|
||
- `POST /tags` — Создать новый тег
|
||
- `DELETE /tags/{tag_id}` — Удалить тег
|
||
|
||
---
|
||
|
||
### 🔗 Назначение тегов к задачам (TaskTags)
|
||
|
||
- `GET /tasks/{task_id}/tags` — Получить все теги задачи
|
||
- `POST /tasks/{task_id}/tags/{tag_id}` — Добавить тег к задаче
|
||
- `DELETE /tasks/{task_id}/tags/{tag_id}` — Удалить тег у задачи
|
||
|
||
---
|
||
|
||
### 🔐 Авторизация (Auth)
|
||
|
||
- `POST /auth/register` — Регистрация нового пользователя
|
||
- `POST /auth/login` — Вход пользователя
|
||
- `POST /auth/logout` — Выход пользователя
|
||
- `POST /auth/refresh` — Обновление токена
|
||
- `GET /auth/me` — Получение данных текущего пользователя
|