Перейти к содержанию

Товары

Получение списка товаров

Метод: GET
URL: https://beta.api.gigma.ru/counterparty/products
Авторизация: -
Headers: Token: {токен приложения из Gigma}

Параметры запроса

  • page - текущая страница (для пагинации)
  • per_page - кол-во элементов на странице
  • query- опциональный параметр, используемый для поиска товаров по названию
  • country_id[] - массив опциональных параметров для фильтрации товаров по ID страны. Для получения списка стран используйте запрос
  • category_id[] - массив опциональных параметров для фильтрации товаров по ID категории. Для получения списка категорий используйте запрос
  • brand_id[] - массив опциональных параметров для фильтрации товаров по ID бренда. Для получения списка брендов используйте запрос
  • order_by - сортировка по: price_asc (увеличению цены), price_desc (уменьшению цены), popularity_asc (увеличению популярности), popularity_desc (уменьшению популярности)
  • available - наличи: online (в интернет-магазинах), offline (в розничным магазинах)
  • sale - true, если поиск товаров со скидками, false - по всем товарам
  • price_from - минимальная цена товара (числовое значение). Для получения минимальной возможной цены и ограничения соответствующей шкалы используйте запрос
  • price_to - максимальная цена товара (числовое значение). Для получения минимальной возможной цены и ограничения соответствующей шкалы используйте запрос

Пример запроса

https://beta.api.gigma.ru/counterparty/products?page=1

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "products": {
        "current_page": 1,
        "data": [
            {
                "id": 26896,
                "views_count": 23,
                "photo": "https:\/\/beta.api.gigma.ru\/storage\/uploads\/7xvG4ZwX4jhjqWwO8Pd11JavGJ2CQ0Z67OUCPWLC.png",
                "name": "Line Repair Nutrient Bio Satin Serum Сыворотка «Био-Сатин», 30 мл",
                "brand": {
                    "id": 99,
                    "name": "Бренд 4",
                    "photo": null,
                    "created_at": "2025-01-27T04:19:22.000000Z"
                },
                "old_price": "2450.00",
                "price": "1960.00",
                "discount": 20,
                "quantity": 5,
                "unit": null,
                "is_favourite": false,
                "tags": []
            }
        ],
        "first_page_url": "http:\/\/192.168.0.43:8000\/counterparty\/products?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http:\/\/192.168.0.43:8000\/counterparty\/products?page=1",
        "links": [
            {
                "url": null,
                "label": "« Предыдущая",
                "active": false
            },
            {
                "url": "http:\/\/192.168.0.43:8000\/counterparty\/products?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Следующая »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http:\/\/192.168.0.43:8000\/counterparty\/products",
        "per_page": 10,
        "prev_page_url": null,
        "to": 1,
        "total": 1
    }
}

Описание полей ответа
  • products.data.id - первичный ключ (ID товара)
  • products.data.views_count - кол-во просмотров
  • products.data.photo - фотография товара
  • products.data.name - название товара
  • products.data.brand - объект с информацией о торговой марке
  • products.data.old_price - старая цена
  • products.data.price - текущая цена
  • products.data.discount - скидка (в %)
  • products.data.quantity - доступно (кол-во)
  • products.data.is_favourite - признак "в избранном"
  • products.data.tags - массив тегов, применяемых к товары
  • pagination - объект с информацией о пагинации и её текущем статусе

Раздел «Избранные»

Получение списка избранных товаров

Метод: GET
URL: https://beta.api.gigma.ru/counterparty/products/favourites
Авторизация: Bearer token
Параметры запроса: отсутствуют
Headers: Token: {токен приложения из Gigma}

Пример запроса

https://beta.api.gigma.ru/counterparty/products/favourites

Ответ

При успешном действии возвращается HTTP код 200. 

{
  "products": {
    "current_page": 1,
    "data": [
      {
        "id": 1,
        "photo": "https://beta.back.erp.itecho.ru/storage/uploads/full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
        "name": "BANILA CO Glow Fit Foundation Brush",
        "old_price": "0.00",
        "price": "2450.00",
        "discount": 0,
        "quantity": 5,
        "unit": "шт.",
        "is_favourite": true
      }
    ],
    "first_page_url": "https://beta.api.gigma.ru/counterparty/products/favourites?page=1",
    "from": 1,
    "last_page": 1,
    "last_page_url": "https://beta.api.gigma.ru/counterparty/products/favourites?page=1",
    "links": [
      {
        "url": null,
        "label": "« Предыдущая",
        "active": false
      },
      {
        "url": "https://beta.api.gigma.ru/counterparty/products/favourites?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": null,
        "label": "Следующая »",
        "active": false
      }
    ],
    "next_page_url": null,
    "path": "https://beta.api.gigma.ru/counterparty/products/favourites",
    "per_page": 10,
    "prev_page_url": null,
    "to": 1,
    "total": 1
  }
}

Описание возвращаемых полей аналогично запросу.

Добавление товара в избранные

Метод: POST
URL: https://beta.api.gigma.ru/counterparty/products/favourites
Авторизация: Bearer token
Headers: Token: {токен приложения из Gigma}

Параметры запроса
  • product_id - ID товара из запроса #Получение списка товаров
Пример запроса

https://beta.api.gigma.ru/counterparty/products/favourites 

{
 "product_id": 1
}

Ответ

При успешном действии возвращается HTTP код 200. 

{
  "product": {
    "id": 1,
    "photos": [
      {
        "id": 14,
        "name": "full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg",
        "path": "https://beta.back.erp.itecho.ru/storage/uploads/full_covericious_glow_fit_foundation_spf25_pa__23_peanut.jpg"
      }
    ],
    "name": "BANILA CO Glow Fit Foundation Brush",
    "description": "BANILA CO Glow Fit Foundation Brush – это инновационная кисть для нанесения тонального средства, которая обеспечивает идеальное покрытие без разводов и пятен. Эта кисть создана для того, чтобы сделать процесс нанесения макияжа быстрым и легким, а результат – просто невероятным.",
    "old_price": "0.00",
    "price": "2450.00",
    "discount": 0,
    "quantity": 5,
    "unit": "шт.",
    "is_favourite": true
  }
}

Описание возвращаемых полей аналогично запросу.

Удаление товара из избранных

Метод: DELETE
URL: https://beta.api.gigma.ru/counterparty/products/favourites/{id}
Авторизация: Bearer token
Параметры запроса: отсутствуют
Headers: Token: {токен приложения из Gigma}

Пример запроса

https://beta.api.gigma.ru/counterparty/products/favourites/1

Ответ

При успешном действии возвращается HTTP код 200. 

{
    "message": "Product successfully deleted from favourites"
}

Описание возвращаемых полей: - message - информационное сообщение. ```