Работа с корзиной

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

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

GET https://api.waix.ru/cart/items?key=ключ-доступа

Метод для получения JSON списка товаров в корзине.

Query Parameters

Name	Type	Description
key или token*	string	Ключ-доступа
sort	string	Способ сортировки. Изначально . Укажите sort=id для сортировки по мере добавления (более ранние позиции вверху списка).

200 Ответ с содержанием списка товаров

{
   "status":"OK",
   "result":[
      {
         "date_create":1575429660,
         "id":52299,
         "image":[
            "http:\/\/d.vaix.ru\/76e7512af65d.jpg"
         ],
         "link":"https:\/\/item.taobao.com\/item.htm?id=578602347732",
         "note":"",
         "number":1,
         "param":[
            {
               "name":"尺码",
               "value":"帽子+围脖(收藏加购送手套)"
            },
            {
               "name":"颜色分类",
               "value":"925-咖啡色"
            }
         ],
         "platform":"taobao.com",
         "price":26.8,
         "price_delivery":0,
         "price_total":26.8,
         "seller":"劲卡龙男装旗舰店",
         "seller_crc":1958537025,
         "taobao_id":"578602347732",
         "title":"帽子男冬天加厚保暖针织毛线帽秋冬季韩版潮加绒防寒骑车男士棉帽"
      },
      {
         "date_create":1575683885,
         "id":53323,
         "image":[
            "http:\/\/d.vaix.ru\/582b4a2e8800.jpg"
         ],
         "link":"https:\/\/item.taobao.com\/item.htm?id=552966909042",
         "note":"",
         "number":1,
         "param":[
            {
               "name":"食品口味",
               "value":"蓝罐[含夏威夷果]"
            }
         ],
         "platform":"taobao.com",
         "price":489,
         "price_delivery":0,
         "price_total":489,
         "seller":"味轩阁",
         "seller_crc":1709928385,
         "taobao_id":"552966909042",
         "title":"柯可蓝美国进口SAVANNA蜂蜜混合坚果仁孕妇零食组合什锦干果罐装"
      }
   ],
   "total": 56
}

302 Ошибка в случае неверного указания ключа.

{"status":"ERROR","result":false,"message":"Некорректный ключ."}

Полная очистка корзины

POST https://api.waix.ru/cart/clear?key=ключ-доступа

Очистка корзины происходит в 2 этапа во избежании случайных срабатываний. 1 шаг. Выполните данный GET запрос для получения code и hash для подтверждения очистки корзины. 2 шаг. Выполните повторный POST запрос и передайте полученные ранее code и hash.

Очистка корзины теперь происходит одним запросом, на своей стороне, вам рекомендуется использовать предупреждения пользователя перед удалением, эту операцию нельзя будет откатить. Лучший вариант: используйте модальное окно с подтверждением действий на клиентской стороне.

Query Parameters

Name	Type	Description
key или token*	string	Ключ-доступа

200 result = количество удаленных позиций

{
    "status":"OK",
    "result":4
}

Внимание! Данный метод полностью очищает все позиции в корзине без возможности их восстановить! Очистка будет произведена даже ранее скрытых/удаленных/спрятанных товаров.

Обновление товара в корзине

POST https://api.waix.ru/cart/update?key=ключ-доступа&id=индентификатор-товара

Метод для обновления позиции в корзине, возвращает JSON успеха всегда независимо от отправленных Form данных.

Query Parameters

Name	Type	Description
key или token*	string	Ключ-доступа
id*	integer	Идентификатор позиции в корзине из списка товаров

Request Body

Name	Type	Description
active	integer	0 — не показывать (удалить) 1 — отображать (восстановить)
number	number	Количество товаров в позиции.

200 На код ответа не обращаем внимания, он всегда 200: OK

{"status":"OK","result":true}

204 Если запрос не POST либо данные не переданы, отображается сообщение

{"status":"ERROR","result":false,"message":"Пустой POST запрос либо содержит недостаточно полей."}

304 Если POST данные отправлены, но товар не обновлен по нескольким причинам, ответ будет ERROR без сообщений об ошибках.

{"status":"ERROR","result":false}

Создать заказ на основе позиций корзины

POST https://api.waix.ru/cart/order

Создает заказ и переносит в него позиции из корзины. Если позиции не выбраны, то будут перенесены все позиции из корзины в новый заказ.

Вы можете отправить GET запрос если вам нет необходимости передавать ids

Query Parameters

Name	Type	Description
key или token*	string	Серверный или клиентский токен (token) или ключ-доступа (key)

Request Body

Name	Type	Description
ids	array	Массив из id позиций, например [5612,95214,132] если массив пустой или ids = null будут выбраны все позиции

200: OK Ответ будет содержать id нового заказа