API корзины управляет корзиной, привязанной к вашему аккаунту. Все эндпоинты корзины требуют заголовок `Authorization`.
Две группы эндпоинтов:
Обзор корзины:
```
GET /api/cart/ Просмотр корзины (общая цена, список товаров)
```
Позиции корзины:
```
POST /api/cart/items/ Добавить товар
PATCH /api/cart/items/{id}/ Обновить количество одной позиции
DELETE /api/cart/items/{id}/ Удалить одну позицию
DELETE /api/cart/items/ Очистить все позиции
```
Форма ответа GET /api/cart/:
```javascript
{
items: [
{
id: 42, // id позиции корзины (не id товара)
product: { id: 7, name: "Oak Chair", price: "149.99", ... },
quantity: 1,
products_price: "149.99"
}
],
total_price: "149.99",
total_quantity: 1
}
```
Каждая позиция имеет свой `id` — он нужен для обновления или удаления. Чтобы добавить товар, нужен его `slug`, а не `id`.
Полный рабочий процесс с корзиной через fetch:
```javascript
const BASE_URL = 'https://apilearn.tukas.dev';
async function getToken() {
const { token } = await fetch(`${BASE_URL}/api/auth/token/`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ username: 'YOUR_USERNAME', password: 'YOUR_PASSWORD' }),
}).then(r => r.json());
return token;
}
async function main() {
const token = await getToken();
const headers = {
'Authorization': `Token ${token}`,
'Content-Type': 'application/json',
};
// Просматриваем корзину
const cart = await fetch(`${BASE_URL}/api/cart/`, { headers }).then(r => r.json());
console.log('Позиций в корзине:', cart.items.length);
// Получаем slug товара
const product = await fetch(`${BASE_URL}/api/products/1/`).then(r => r.json());
const slug = product.slug;
// Добавляем в корзину
const item = await fetch(`${BASE_URL}/api/cart/items/`, {
method: 'POST',
headers,
body: JSON.stringify({ product_slug: slug, quantity: 2 }),
}).then(r => r.json());
console.log('Id позиции корзины:', item.id);
// Обновляем количество
const updated = await fetch(`${BASE_URL}/api/cart/items/${item.id}/`, {
method: 'PATCH',
headers,
body: JSON.stringify({ quantity: 5 }),
}).then(r => r.json());
console.log('Новое количество:', updated.quantity);
// Удаляем одну позицию
await fetch(`${BASE_URL}/api/cart/items/${item.id}/`, {
method: 'DELETE', headers,
});
// Очищаем всю корзину
await fetch(`${BASE_URL}/api/cart/items/`, { method: 'DELETE', headers });
const empty = await fetch(`${BASE_URL}/api/cart/`, { headers }).then(r => r.json());
console.log('Позиций после очистки:', empty.items.length); // 0
}
main();
```
**Эндпоинты (все требуют Authorization)**
```
GET /api/cart/ Просмотр корзины
POST /api/cart/items/ Добавить позицию
тело: { product_slug: string, quantity: number }
возвращает: 201 + объект позиции корзины
PATCH /api/cart/items/{id}/ Обновить количество
тело: { quantity: number }
возвращает: 200 + обновлённая позиция
DELETE /api/cart/items/{id}/ Удалить одну позицию → 204
DELETE /api/cart/items/ Очистить все позиции → 204
```
**Форма ответа корзины**
```javascript
{ items: [...], total_price: "149.99", total_quantity: 1 }
```
**Объект позиции корзины**
```javascript
{ id: 42, product: {...}, quantity: 2, products_price: "299.98" }
```
**Ключевое различие**
```
product.slug — используется при добавлении в корзину (тело POST)
item.id — используется при обновлении/удалении (параметр URL)
```
**DELETE возвращает 204 — без тела**
```javascript
// Не вызывайте .json() на ответ 204
await fetch(url, { method: 'DELETE', headers });
// Проверьте response.ok, если нужно подтвердить успех
```