Магазин

Эндпоинты для работы с магазином, товарами, корзиной и заказами.

GET /v1/shop Public

Получить список товаров с пагинацией и фильтрацией по категории.

Параметры:
Параметр Тип Описание
limit integer Количество записей (по умолчанию 20)
offset integer Сдвиг для пагинации
category string Фильтр по категории
Пример запроса:
curl -X GET "https://api.neoswift.site/v1/shop?limit=10&category=software"
GET /v1/shop/{id} Public

Получить информацию о товаре по ID.

Параметры:
Параметр Тип Описание
id integer ID товара
Пример запроса:
curl -X GET "https://api.neoswift.site/v1/shop/1"
GET /v1/shop/categories Public

Получить список категорий товаров.

Пример запроса:
curl -X GET "https://api.neoswift.site/v1/shop/categories"
POST /v1/shop/cart Protected

Добавить товар в корзину.

Параметры:
Параметр Тип Описание
product_id integer ID товара
quantity integer Количество (по умолчанию 1)
Пример запроса:
curl -X POST "https://api.neoswift.site/v1/shop/cart" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1, "quantity": 2}'
GET /v1/shop/cart Protected

Получить содержимое корзины.

Пример запроса:
curl -X GET "https://api.neoswift.site/v1/shop/cart" \
  -H "Authorization: Bearer YOUR_TOKEN"
POST /v1/shop/favorite Protected

Добавить товар в избранное.

Параметры:
Параметр Тип Описание
product_id integer ID товара
Пример запроса:
curl -X POST "https://api.neoswift.site/v1/shop/favorite" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 1}'
POST /v1/shop/orders Protected

Оформить заказ (корзина будет очищена).

Пример запроса:
curl -X POST "https://api.neoswift.site/v1/shop/orders" \
  -H "Authorization: Bearer YOUR_TOKEN"