POST api/seller-goods

Товары продавца

Request Information

URI Parameters

None.

Body Parameters

SellerGoodsRequest

SellerGoodsRequest
NameDescriptionTypeAdditional information
id_seller

идентификатор продавца

integer

None.

page

номер страницы (если не указывать номер страницы, то отображается первая страница)

integer

None.

rows

количество единиц на странице (не более 2000)

integer

None.

currency

тип валюты для отображения цены товара: USD | RUR | EUR | UAH

string

None.

order_col

способ сортировки товаров: name — названию; price — цене; cntsell — продаж; cntreturn — возвратов; cntgoodresponses — положит. отзывов; cntbadresponses — отриц. отзывов; если не указывать, то сортируются по количеству продаж (убывание).

string

None.

order_dir

способ сортировки товаров: asc — А - Я, возрастание; desc — Я - А, убывание.

string

None.

lang

язык: ru-RU | en-US

string

None.

show_hidden

скрытые товары: 0|1

integer

None.

Request Formats

application/json, text/json

Sample:
{
  "id_seller": 1,
  "page": 2,
  "rows": 3,
  "currency": "sample string 4",
  "order_col": "sample string 5",
  "order_dir": "sample string 6",
  "lang": "sample string 7",
  "show_hidden": 1
}

application/x-www-form-urlencoded

Sample:

Sample not available.

application/xml, text/xml

Sample:
<digiseller.request>
  <id_seller>1</id_seller>
  <page>2</page>
  <rows>3</rows>
  <currency>sample string 4</currency>
  <order_col>sample string 5</order_col>
  <order_dir>sample string 6</order_dir>
  <lang>sample string 7</lang>
  <show_hidden>1</show_hidden>
</digiseller.request>

Response Information

Resource Description

Ответ товары продавца

SellerGoodsResponse
NameDescriptionTypeAdditional information
retval

код выполнения запроса 0 — запрос успешно отработан коды ошибок валидации запроса: 1 - неверно задан параметр id_seller; 2 - неверно задан параметр page; 3 - неверно задан параметр rows; 4 - неверно задан параметр currency; 5 - неверно задан параметр order_col; 6 - неверно задан параметр order_dir.

integer

None.

retdesc

описание кода выполнения

string

None.

id_seller

идентификатор продавца

integer

None.

name_seller

псевдоним (никнейм) продавца

string

None.

show_hidden

скрытые товары

integer

None.

cnt_goods

количество товаров в категории

integer

None.

pages

всего страниц

integer

None.

page

номер страницы

integer

None.

order_col

выбранная колонка сортировки

string

None.

order_dir

выбранный способ сортировки

string

None.

Rows

список товаров магазина

SellerGoodsRows

None.

Response Formats

application/json, text/json

Sample:
{
  "retval": 1,
  "retdesc": "sample string 2",
  "id_seller": 3,
  "name_seller": "sample string 4",
  "show_hidden": 5,
  "cnt_goods": 6,
  "pages": 7,
  "page": 8,
  "order_col": "sample string 9",
  "order_dir": "sample string 10",
  "rows": [
    null,
    {
      "id_goods": 2,
      "name_goods": "",
      "info_goods": "",
      "add_info": "",
      "price": 3.0,
      "currency": "sample string 4",
      "cnt_sell": 5,
      "cnt_sell_hidden": 6,
      "cnt_return": 7,
      "cnt_return_hidden": 8,
      "cnt_goodresponses": 9,
      "cnt_goodresponses_hidden": 10,
      "cnt_badresponses": 11,
      "cnt_badresponses_hidden": 12,
      "price_usd": 13.0,
      "price_rur": 14.0,
      "price_eur": 15.0,
      "price_uah": 16.0,
      "in_stock": 17,
      "num_in_stock": 1,
      "commiss_agent": 19.0,
      "has_discount": 20,
      "num_options": 21,
      "release_date": "19.10.2020 22:50:35",
      "sale_info": null
    }
  ]
}

application/xml, text/xml

Sample:
<digiseller.response>
  <retval>1</retval>
  <retdesc>sample string 2</retdesc>
  <id_seller>3</id_seller>
  <name_seller>sample string 4</name_seller>
  <show_hidden>5</show_hidden>
  <cnt_goods>6</cnt_goods>
  <pages>7</pages>
  <page>8</page>
  <order_col>sample string 9</order_col>
  <order_dir>sample string 10</order_dir>
  <rows cnt="2">
    <row id="1">
      <id_goods>2</id_goods>
      <name_goods><![CDATA[]]></name_goods>
      <info_goods><![CDATA[]]></info_goods>
      <add_info><![CDATA[]]></add_info>
      <price>3</price>
      <currency>sample string 4</currency>
      <cnt_sell>5</cnt_sell>
      <cnt_sell_hidden>6</cnt_sell_hidden>
      <cnt_return>7</cnt_return>
      <cnt_return_hidden>8</cnt_return_hidden>
      <cnt_goodresponses>9</cnt_goodresponses>
      <cnt_goodresponses_hidden>10</cnt_goodresponses_hidden>
      <cnt_badresponses>11</cnt_badresponses>
      <cnt_badresponses_hidden>12</cnt_badresponses_hidden>
      <price_usd>13</price_usd>
      <price_rur>14</price_rur>
      <price_eur>15</price_eur>
      <price_uah>16</price_uah>
      <in_stock>17</in_stock>
      <num_in_stock>1</num_in_stock>
      <commiss_agent>19</commiss_agent>
      <has_discount>20</has_discount>
      <num_options>21</num_options>
      <release_date>19.10.2020 22:50:35</release_date>
    </row>
  </rows>
</digiseller.response>