API

Список категорий (каталог)

xml json

URL для передачи запроса:	https://api.digiseller.com/api/categories?seller_id={seller_id}
Метод:	GET
Заголовки запроса:	Accept: application/json Accept: text/xml
Параметры запроса:	Название Назначение Примечание seller_id идентификатор продавца () целое число category_id идентификатор категории целое число 0 - выбирается все дерево каталога lang язык отображения информации ru-RU (по умолчанию) или en-US
Формат ответа: пример XML-ответа пример JSON-ответа	{ "retval": 0, "retdesc": "", "category": [ { "id": "0", "name": "", "cnt": "0" }, { "id": "0", "name": "", "cnt": "0", "sub": { "id": "0", "name": "", "cnt": "0" ... } } ... ] } <digiseller.response> <retval></retval> <retdesc></retdesc> <categories> <category cnt="" sub=""> <id></id> <name></name> </category> <category cnt="" sub=""> <id></id> <name></name> <category cnt="" sub=""> <id></id> <name></name> ... </category> </category> ... </categories> </digiseller.response>
Параметры ответа:	Название Название Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса category список категорий магазина category\*\id идентификатор категории category\*\name название категории category\*\cnt количество товаров в категории category\*\sub список подкатегорий Название Название Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса categories список категорий магазина categories\category параметры категории cnt - количество товаров в категории sub - наличие подкатегорий в выбранной категории categories\category\id идентификатор категории categories\category\name название категории

Список товаров из категории

xml json

URL для передачи запроса:	https://api.digiseller.com/api/shop/products?seller_id={seller_id}&category_id={category_id}
Метод:	GET
Заголовки запроса:	Accept: application/json Accept: text/xml
Параметры запроса:	Название Назначение Примечание seller_id идентификатор продавца целое число category_id идентификатор категории целое число если указать: 0 - отбираются товары добавленные на главную страницу -1 - отбираются товары со знаком "скидка" -2 - отбираются товары со знаком "новинка" -3 - отбираются товары со знаком "популярный" page номер страницы (если не указывать номер страницы, то отображается первая страница) целое число rows количество строк на странице целое число (значение по умолчанию 20, max. 500) order способ сортировки товаров ( если не указывать, то расположение товаров как в "Моем магазине" ) name - сортировка по названию, nameDESC - сортировка по названию (обрат.), price - сортировка по цене, priceDESC - сортировка по цене (обрат.) currency тип валюты для отображения стоимости товара USD, RUR, EUR или UAH lang язык отображения информации ru-RU (по умолчанию) или en-US
Формат ответа: пример JSON-ответа пример XML-ответа	{ "retval": "0", "retdesc": "", "lang": "", "totalPages": "0", "totalItems": "0", "breadCrumbs": [ { "id": "0", "name": "" }, ... ], "categories": [ { "id": "0", "name": "", "hasImg": "0", "cnt": "0" }, ... ], "product": [ { "id": "0", "name": "", "cntImg": "0", "info": "", "price": "0", "base_price": "0", "base_currency": "", "currency": "", "price_rub": "0", "price_usd": "0", "price_eur": "0", "price_uah": "0", "partner_comiss": "0", "agency_id": "0", "collection": "", "is_available": 0, "has_discount": 0, "id_present": 0, "sale_info": { "common_base_price": "", "common_price_usd": "", "common_price_rur": "", "common_price_eur": "", "common_price_uah": "", "sale_end": "", "sale_percent": "" }, "label": "" }, ... ] } <digiseller.response> <retval></retval> <retdesc></retdesc> <categories> <category cnt=""> <id></id> <name></name> <category cnt=""> <id></id> <name></name> ... </category> </category> </categories> <seller> <id></id> </seller> <pages cnt=""> <num></num> <rows></rows> </pages> <subcategories> <subcategory cnt=""> <id></id> <name></name> </subcategory> <subcategory cnt=""> <id></id> <name></name> </subcategory> ... </subcategories> <products cnt=""> <order></order> <currency></currency> <product img="" icon=""> <id></id> <name><![CDATA[]]></name> <info><![CDATA[]]></info> <price></price> <base_price></base_price> <base_currency></base_currency> <price_rub></price_rub> <price_usd></price_usd> <price_eur></price_eur> <price_uah></price_uah> <partner_comiss></partner_comiss> <collection></collection> <in_stock></in_stock> <num_in_stock></num_in_stock> <has_discount></has_discount> <id_present></id_present> <sale_info> <common_base_price></common_base_price> <common_price_usd></common_price_usd> <common_price_rur></common_price_rur> <common_price_eur></common_price_eur> <common_price_uah></common_price_uah> <sale_end></sale_end> <sale_percent></sale_percent> </sale_info> </product> ... </products> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса product\\lang язык product\\totalPages всего страниц product\\totalItems всего товаров breadCrumbs путь к выбранной категории, список категорий breadCrumbs\\id идентификатор категории breadCrumbs\\name название категории categories список подкатегорий categories\\id идентификатор подкатегории categories\\name название подкатегории categories\\cnt количество товаров в подкатегории product параметры списка товаров product\\id идентификатор товара product\\name название товара product\\cntImg количество изображений product\\info описание товара product\\price стоимость товара product\\base_price цена в базовой валюте, установленной продавцом product\\base_currency базовая валюта product\\price_rub стоимость товара, RUB product\\price_usd стоимость товара, USD product\\price_eur стоимость товара, EUR product\\price_uah стоимость товара, UAH product\\partner_comiss партнерское вознаграждение % product\\agency_id идентификатор партнера product\\collection вид содержимого товара digi | pins | unit | book | soft product\\is_available доступность товара 0 - товар отсутствует 1 - товар в наличии Внимание! Для того, чтобы метод возвращал данные о товаре, даже если он закончился, убедитесь, что параметр "Товары, которые закончились" выставлен в значении "отображать" на странице настроек отображения product\\num_in_stock доступное для оплаты количество единиц товара Для получения этой информации вам необходимо связаться с поддержкой сервиса и подтвердить свое намерение сделать этот параметр публичным. По умолчанию параметр доступен только по токену. product\\has_discount скидка постоянным покупателям 0 - скидка не предоставляется 1 - скидка предоставляется product\\id_present ID товара-подарка 0 - подарок не задан product\\sale_info информация о распродаже product\\sale_info\common_base_price базовая стоимость до распродажи product\\sale_info\common_price_usd цена до распродажи. валюта: USD product\\sale_info\common_price_rur цена до распродажи. валюта: RUR product\\sale_info\common_price_eur цена до распродажи. валюта: EUR product\\sale_info\common_price_uah цена до распродажи. валюта: UAH product\\sale_info\sale_end дата окончания действия распродажи product\\sale_info\sale_percent процент скидки product\\icon наличие знака "скидка" (sale), "новинка" (new), "популярный товар" (top) Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса categories путь к выбранной категории categories\category список категорий cnt - количество товаров в категории categories\category\id идентификатор категории categories\category\name название категории seller\id идентификатор продавца переданный в запросе subcategories\subcategory список подкатегорий cnt - количество товаров в подкатегории subcategories\subcategory\id идентификатор подкатегории subcategories\subcategory\name название подкатегории pages параметры страниц атрибут cnt-количество страниц pages\num номер страницы переданный в запросе pages\rows количество строк на странице products параметры списка товаров products\order способ сортировки товаров переданный в запросе products\currency тип валюты для отображения цены, переданный в запросе products\product параметры товара атрибут img - наличие/отсутствие (yes/no) картинки предварительного просмотра атрибут icon - наличие знака "скидка" (sale), "новинка" (new), "популярный товар" (top) products\product\id идентификатор товара products\product\name название товара products\product\info описание товара products\product\price стоимость товара products\product\base_price цена в базовой валюте, установленной продавцом products\product\base_currency базовая валюта products\product\partner_comiss партнерское вознаграждение % products\product\collection вид содержимого товара digi | pins | unit | book | soft products\product\in_stock доступность товара 0 - товар отсутствует 1 - товар в наличии Внимание! Для того, чтобы метод возвращал данные о товаре, даже если он закончился, убедитесь, что параметр "Товары, которые закончились" выставлен в значении "отображать" на странице настроек отображения products\product\num_in_stock доступное для оплаты количество единиц товара Для получения этой информации вам необходимо связаться с поддержкой сервиса и подтвердить свое намерение сделать этот параметр публичным. По умолчанию параметр доступен только по токену. products\product\has_discount скидка постоянным покупателям 0 - скидка не предоставляется 1 - скидка предоставляется products\product\id_present ID товара-подарка 0 - подарок не задан products\sale_info информация о распродаже products\sale_info\common_base_price базовая стоимость до распродажи products\sale_info\common_price_usd цена до распродажи. валюта: USD products\sale_info\common_price_rur цена до распродажи. валюта: RUR products\sale_info\common_price_eur цена до распродажи. валюта: EUR products\sale_info\common_price_uah цена до распродажи. валюта: UAH products\sale_info\sale_end дата окончания действия распродажи products\sale_info\sale_percent процент скидки

Быстрое получение описаний товаров по списку ID

xmljson

URL для передачи запроса:	https://api.digiseller.com/api/products/list?ids=0,0&lang=ru-RU
Заголовки запроса:	Content-Type: "application/xml" Accept: "application/xml" Content-Type: "application/json" Accept: "application/json"
Метод:	GET | POST
Формат запроса:	<digiseller.request> <ids> <id></id> ... </ids> <lang></lang> <token></token> </digiseller.request>
Формат запроса:	{ "ids":[ 0, ... ], "lang": "", "token": "" }
Параметры запроса:	Название Назначение Примечание ids\id идентификаторы товаров целое число (не более 2000) lang язык отображения информации ru-RU (по умолчанию) или en-US token токен, полученный от api/apilogin, если указан и принадлежит владельцу товара, тогда значения параметров num_in_stock, cnt_sell и cnt_return не будут скрытыми; мин. разрешение: [ Товары ]: Просматривать необязательный параметр
Формат ответа:	<digiseller.response> <product> <id></id> <id_seller></id_seller> <name></name> <info></info> <add_info></add_info> <collection></collection> <base_currency></base_currency> <base_price></base_price> <price_usd></price_usd> <price_rub></price_rub> <price_eur></price_eur> <price_uah></price_uah> <cnt_sell>63</cnt_sell> <cnt_sell_hidden>0</cnt_sell_hidden> <cnt_return>0</cnt_return> <cnt_return_hidden>0</cnt_return_hidden> <in_stock></in_stock> <num_in_stock></num_in_stock> <num_in_lock></num_in_lock> <sale_info> <common_base_price></common_base_price> <common_price_usd></common_price_usd> <common_price_rur></common_price_rur> <common_price_eur></common_price_eur> <common_price_uah></common_price_uah> <sale_begin></sale_begin> <sale_end></sale_end> <sale_percent></sale_percent> </sale_info> </product> ... </digiseller.response>
Формат ответа:	[ { "id": 0, "id_seller": 0, "name": "", "info": "", "add_info": "", "collection": "", "base_currency": "", "base_price": 0.00, "price_usd": 0.00, "price_rub": 0.00, "price_eur": 0.00, "price_uah": 0.00, "cnt_sell": 63, "cnt_sell_hidden": 0, "cnt_return": 0, "cnt_return_hidden": 0, "in_stock": 1, "num_in_stock": 0, "num_in_lock": 0, "owner_id": 0, "release_date": null "sale_info": { "common_base_price": 0.00, "common_price_usd": 0.00, "common_price_rur": 0.00, "common_price_eur": 0.00, "common_price_uah": 0.00, "sale_begin": "30.12.2020 13:00:00", "sale_end": "31.12.2020 20:00:00", "sale_percent": 0.00 } }, ... ]
Параметры ответа:	Название Назначение Примечание product\id идентификатор товара product\id_seller идентификатор продавца product\name название товара CDATA product\info описание товара CDATA product\add_info дополнительная информация о товаре CDATA product\collection вид содержимого товара digi | pins | unit | book | soft product\base_currency базовая валюта product\base_price цена в базовой валюте, установленной продавцом product\price_usd цена в usd product\price_rub цена в rub product\price_eur цена в eur product\price_uah цена в uah product\cnt_sell количество продаж int; -1 означает полностью скрыто. Чтобы это свойство стало открытым для всех, в настройках товара необходимо включить параметр "Отображение числа продаж". По умолчанию значение параметра доступно только по токену владельца товара. product\cnt_sell_hidden режим отображения числа продаж 0 - продажи открыты 1 - продажи скрыты (реальное количество продаж > cnt_sell) product\cnt_return количество возвратов int; -1 означает полностью скрыто. Чтобы это свойство стало открытым для всех, в настройках товара необходимо включить параметр "Отображение числа продаж". По умолчанию значение параметра доступно только по токену владельца товара. product\cnt_return_hidden режим отображения числа возвратов 0 - возвраты открыты 1 - возвраты скрыты (реальное количество возвратов > cnt_return) product\in_stock доступность товара 0 - товар отсутствует; 1 - товар в наличии. product\num_in_stock доступное для оплаты количество единиц товара Чтобы это свойство стало открытым для всех, в настройках товара необходимо включить параметр "Отображение остатка". По умолчанию значение параметра доступно только по токену владельца товара. product\num_in_lock количество товаров, зарезервированных под оплату product\owner_id код торговой площадки product\release_date дата релиза product\sale_info информация о распродаже product\sale_info\common_base_price базовая стоимость до распродажи product\sale_info\common_price_usd цена до распродажи. валюта: USD product\sale_info\common_price_rur цена до распродажи. валюта: RUR product\sale_info\common_price_eur цена до распродажи. валюта: EUR product\sale_info\common_price_uah цена до распродажи. валюта: UAH product\sale_info\sale_begin дата начала действия распродажи product\sale_info\sale_end дата окончания действия распродажи product\sale_info\sale_percent процент скидки

Описание товара

xml json

URL для передачи запроса:	https://api.digiseller.com/api/products/{product_id}/data
Метод:	GET
Заголовки запроса:	Accept: application/json Accept: text/xml
Параметры запроса:	Название Назначение Примечание token токен, полученный от api/apilogin, если указан и принадлежит владельцу товара, тогда значение параметра num_in_stock не будет скрыто; мин. разрешение: [ Товары ]: Просматривать Так же, если указан, учитывается для учета индивидуальных партнерских отчислений необязательный параметр product_id идентификатор товара целое число seller_id необязательный параметр, указывайте если используете корзину. идентификатор продавца товара или свой идентификатор (если товар принадлежит вам или вы добавили его в свой магазин) целое число currency валюта USD (по умолчанию) или RUB | EUR | UAH lang язык отображения информации ru-RU (по умолчанию) или en-US owner при передаче значения = 1 в ответе будут присутствовать все способы оплаты, поддерживаемые торговой площадкой (если товар размещен на торговой площадке) необязательный параметр showHiddenVariants при передаче значения = 1 в ответе будут присутствовать все варианты значений параметра необязательный параметр
Формат ответа: пример JSON-ответа пример XML-ответа	{ "retval": 0, "retdesc": "", "queryId": "", "product": { "id": 2661878, "id_prev": 2657311, "id_next": 0, "name": "Бугрики", "price": 1.12, "currency": "USD", "is_available": 1, "url": "", "info": "тест уникального товара", "add_info": "", "release_date": "28.05.2019 14:32:39", "agency_fee": 1.12, "agency_sum": 0.12, "agency_id": 0, "collection": "unit", "propertygood": 2, "show_rest": 1, "num_in_stock": 3, "num_in_lock": 2, "pwyw": 0, "label": "", "prices": { "initial": { "RUB": 0.12, "USD": 0.12, "EUR": 0.12, "UAH": 0.12, "mBTC": 0.123456, "mLTC": 0.123456 }, "default": { "RUB": 0.12, "USD": 0.12, "EUR": 0.12, "UAH": 0.12, "mBTC": 0.123456, "mLTC": 0.123456 } }, "payment_methods": [ { "name": "WebMoney", "currencies": [ { "currency": "USD", "code": "WMZ", "price": 0.1234 "limit": { "min": 0.10, "max": 5000.00, "currency": "USD" } }, ... ], }, ... ], "prices_unit": { "unit_name": "BUG", "unit_amount": 1.12, "unit_amount_desc": "RUB", "unit_currency": "USD", "unit_cnt": 1.12, "unit_cnt_min": 100, "unit_cnt_max": 500, "unit_cnt_desc": "", "unit_fixed": [ 100, ... ], "unit_only_int": 1 }, "unique_code_verification": { "automatic": 1, "deliver_url": "https://example.com/goto", "has_params": 1, "params": [ { "id": 38330, "name": "p1", "required": 1 }, { "id": 38331, "name": "p2", "required": 1 } ], "return": 1, "return_url": "https://example.com/return" }, "preview_imgs": [ { "id": 1, "url": "http..", "width": 320, "height": 240 }, ... ], "preview_videos": [ { "type": "youtube", "id": "1", "preview": "http.." }, ... ], "type": "text", "text": { "date": "28.05.2019 14:32:39", "size": 16 }, "file": { "date": "28.05.2019 14:32:39", "size": 16, "name": "trial-app.zip", "trial": 1 }, "category_id": 78099, "breadcrumbs": [ { "id": 78099, "name": "Тестирование [виджета]", "products_cnt": 17 }, ... ], "discounts": [ { "summa": 100.0, "percent": 20.0 }, ... ], "units": { "desc": "1 BUG", "price": 1.0, "discounts": [ { "desc": "discount descrition", "percent": 3.0, "price": 80.0, "cnt": 10 }, ... ] }, "present": { "id": 1, "name": "some present" }, "gift_commiss": 5.0, "options": [ { "name": "", "label": "", "comment": "", "type": "", "separate_content": 1, "required": 1, "modifier_visible": 1, "variants": [ { "value": 1, "text": "", "default": 1, "modify": "", "modify_type": "", "modify_value": 0, "modify_value_default": 0, "num_in_stock": 0, "visible": 1 }, ... ] }, ... ], "options_check": 1, "statistics": { "sales": 0, "refunds": 0, "good_reviews": 0, "bad_reviews": 0, "sales_hidden": 0, "refunds_hidden": 0, "good_reviews_hidden": 0, "bad_reviews_hidden": 0 }, "seller": { "id": 12126, "name": "WYSIWYG" }, "sale_info": { "common_base_price": 0.0, "common_price_usd": 0.0, "common_price_rub": 0.0, "common_price_eur": 0.0, "common_price_uah": 0.0, "sale_end": "28.05.2019 14:32:39", "sale_percent": 0.0 } } } <digiseller.response> <retval></retval> <retdesc></retdesc> <product icon=""> <id></id> <name></name> <url></url> <info></info> <add_info></add_info> <release_date></release_date> <agency_fee></agency_fee> <collection></collection> <propertygood></propertygood> <in_stock></in_stock> <is_available></is_available> <show_rest></show_rest> <num_in_stock></num_in_stock> <num_in_lock></num_in_lock> <prices> <initial> <price> <currency>RUB</currency> <price>0.12</price> </price> ... </initial> <default> <price> <currency>RUB</currency> <price>10.12</price> </price> ... </default> </prices> <payment_methods> <payment_method> <name></name> <currencies> <currency> <currency></currency> <code></code> <price></price> <limit> <min></min> <max></max> <currency></currency> </limit> </currency> ... </currencies> </payment_method> ... </payment_methods> <prices_unit> <unit_name>ЕД</unit_name> <unit_amount>0,15</unit_amount> <unit_amount_desc>RUB</unit_amount_desc> <unit_currency>USD</unit_currency> <unit_cnt>1</unit_cnt> <unit_cnt_min></unit_cnt_min> <unit_cnt_max></unit_cnt_max> <unit_cnt_desc></unit_cnt_desc> <unit_fixed> <unit_fixed>1</unit_fixed> <unit_fixed>10</unit_fixed> <unit_fixed>100</unit_fixed> </unit_fixed> <unit_only_int></unit_only_int> </prices_unit> <unique_code_verification> <automatic>1</automatic> <deliver_url>https://example.com/goto</deliver_url> <has_params>1</has_params> <params> <param> <id>38330</id> <name>p1</name> <required>1</required> </param> <param> <id>38331</id> <name>p2</name> <required>1</required> </param> </params> <return>1</return> <return_url>https://example.com/return</return_url> </unique_code_verification> <preview_imgs cnt=""> <preview_img id=""> <img_small height="" width=""></img_small> <img_real height="" width=""></img_real> </preview_img> ... </preview_imgs> <preview_videos cnt=""> <preview_video> <type></type> <id></id> <preview></preview> </preview_video> ... </preview_videos> <type></type> <text> <date></date> <size></size> </text> <file> <date></date> <size></size> <name></name> <trial></trial> </file> <categories> <category cnt=""> <id></id> <name></name> <category cnt=""> <id></id> <name></name> ... </category> </category> </categories> <discounts> <discount> <summa></summa> <percent></percent> </discount> ... </discounts> <units> <desc></desc> <price></price> <discounts> <discount> <desc></desc> <percent></percent> <price></price> <cnt></cnt> </discount> ... </discounts> </units> <present> <id></id> <name></name> </present> <gift_commiss>0</gift_commiss> <options> <option> <name></name> <label></label> <comment></comment> <type></type> <separate_content>1</separate_content> <required>1</required> <modifier_visible>1</modifier_visible> <variants> <variant> <value></value> <text></text> <default>0</default> <modify></modify> <modify_type></modify_type> <modify_value>0</modify_value> <modify_value_default>0</modify_value_default> <num_in_stock>0</num_in_stock> <visible>1</visible> </variant> ... </variants> </option> ... </options> <options_check></options_check> <statistics> <sales></sales> <refunds></refunds> <good_reviews></good_reviews> <bad_reviews></bad_reviews> <sales_hidden></sales_hidden> <refunds_hidden></refunds_hidden> <good_reviews_hidden></good_reviews_hidden> <bad_reviews_hidden></bad_reviews_hidden> </statistics> <seller> <id></id> <name></name> </seller> <sale_info> <common_base_price></common_base_price> <common_price_usd></common_price_usd> <common_price_rub></common_price_rub> <common_price_eur></common_price_eur> <common_price_uah></common_price_uah> <sale_end></sale_end> <sale_percent></sale_percent> </sale_info> </product> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса product характеристики товара атрибут icon - наличие знака "скидка" (sale), "новинка" (new), "популярный товар" (top) product\id идентификатор товара product\id_prev идентификатор предыдущего товара в категории product\id_next идентификатор следующего товара в категории product\name название товара product\price цена product\currency валюта цены product\url URL товара product\info описание товара product\add_info дополнительная информация о товаре product\release_date дата релиза товара для товаров типа "предзаказ" product\agency_fee размер агентского вознаграждения product\agency_sum размер агентского вознаграждения product\agency_id ID агента product\collection тип товара book - электронная книга | digi - цифровой товар | pins - пин-коды | soft - программа | unit - товар с нефиксированной ценой product\propertygood содержимое товара 1 - универсальное, 2 - уникальное product\is_available доступность товара 0 - товар отсутствует 1 - товар в наличии product\show_rest отображение остатка 0 - скрывается 1 - не скрывается, значение в параметре num_in_stock product\num_in_stock доступное для оплаты количество единиц товара Для получения этой информации нужно либо передать токен владельца, либо включить показ остатка в настройках товара. По умолчанию значение параметра недоступно. см. описание входного параметра token. product\num_in_lock количество товаров, зарезервированных под оплату product\prices основные показатели цены Применимо только для товаров с фиксированной ценой (collection != unit). Стоимость единицы товара с нефиксированной ценой (collection == unit) рассчитывайте с помощью этого метода API. product\prices\initial базовая цена product\prices\initial\currency валюта product\prices\initial\price цена product\prices\default цена основного способа оплаты product\prices\default\currency валюта product\prices\default\price цена product\payment_methods способы оплаты product\payment_methods\name способ оплаты product\payment_methods\currencies список валют product\payment_methods\currencies\currency валюта product\payment_methods\currencies\code трехзначный код метода оплаты product\payment_methods\currencies\price цена product\payment_methods\currencies\limit ограничения способа оплаты (если есть) product\payment_methods\currencies\limit\min минимальный платеж product\payment_methods\currencies\limit\max максимальный платеж product\payment_methods\currencies\limit\currency валюта product\prices_unit цена уникального товара с нефиксированной ценой product\prices_unit\unit_name название единицы product\prices_unit\unit_amount единица товара product\prices_unit\unit_amount_desc единица товара product\prices_unit\unit_currency валюта product\prices_unit\unit_cnt количество product\prices_unit\unit_cnt_min минимально можно купить product\prices_unit\unit_cnt_max максимально можно купить product\prices_unit\unit_cnt_desc описание product\prices_unit\unit_fixed фиксированные значения количества единиц product\prices_unit\unit_only_int только целое количество (не дробное) product\unique_code_verification проверка уникального кода только для уникального кода с фиксированной ценой product\unique_code_verification\automatic флажок 0 - ручная(после оплаты покупатель сообщает вам уникальный код, вы проверяете его через форму в самом верху); 1 - автоматическая(после оплаты покупатель будет автоматически перенаправлен на указанную вами web-страницу с кодом в строке запроса). product\unique_code_verification\deliver_url url для автоматической проверки кода На указанный вами адрес (URL) система автоматически направит покупателя сразу после завершения им платежа. Уникальный код будет добавлен к указанному URL в качестве GET-параметра uniquecode (например, http://мой.сайт/моя_страница?uniquecode=XXXXXXXXXXXXXXXX). С помощью API вы можете проверить его подлинность и получить все основные реквизиты платежа для завершения сделки на вашем сайте. product\unique_code_verification\has_params продавец будет передавать на страницу оплаты свои дополнительные параметры 0 | 1 product\unique_code_verification\params\param параметр product\unique_code_verification\params\param\id ID параметра product\unique_code_verification\params\param\name название параметра product\unique_code_verification\params\param\required параметр является обязательным product\unique_code_verification\return при отсутствии дополнительных параметров продавца на странице оплаты 0 - продолжить покупку; 1 - возвращать покупателя. product\unique_code_verification\return_url URL куда покупатель будет возвращен при отсутствии дополнительных параметров продавца на странице покупки product\preview_imgs параметры изображений предварительного просмотра product\preview_imgs\id id product\preview_imgs\url URL реального изображения product\preview_imgs\width ширина изображения в пикселях product\preview_imgs\height высота изображения в пикселях product\preview_videos параметры video предварительного просмотра product\preview_videos\type тип video youtube или vimeo product\preview_videos\id id product\preview_videos\preview изображение предварительного просмотра video product\preview_imgs параметры изображений предварительного просмотра атрибут cnt - количество изображений product\preview_imgs\preview_img параметры изображения атрибут id product\preview_imgs\preview_img\img_small URL уменьшенного изображения атрибут width-ширина изображения в пикселях атрибут height-высота изображения в пикселях product\preview_imgs\preview_img\img_real URL реального изображения атрибут width-ширина изображения в пикселях атрибут height-высота изображения в пикселях product\preview_videos параметры video предварительного просмотра атрибут cnt - количество video product\preview_videos\preview_video\video_type тип video youtube или vimeo product\preview_videos\preview_video\video_id id product\preview_videos\preview_video\video_preview изображение предварительного просмотра video product\type тип товара text - товар в виде текста file - товар в виде файла product\text параметры товара (тип товара text) product\text\date дата размещения формат: ДД.ММ.ГГГГ ч:мм:сс product\text\size количество символов product\file параметры товара (тип товара file) product\file\date дата размещения формат: ДД.ММ.ГГГГ ч:мм:сс product\file\size размер файла (байт) product\file\name имя файла product\file\trial URL пробной версии товара product\category_id идентификатор категории Для получения этой информации нужно передать значение входного параметра seller_id. product\breadcrumbs путь к категории Для получения этой информации нужно передать значение входного параметра seller_id. product\breadcrumbs\id идентификатор категории product\breadcrumbs\name название категории product\breadcrumbs\products_cnt количество товаров в категории product\categories путь к категории Для получения этой информации нужно передать значение входного параметра seller_id. product\categories\category список категорий атрибут cnt - количество товаров в категории product\categories\category\id идентификатор категории product\categories\category\name название категории product\categories\category\category список категорий атрибут cnt - количество товаров в категории product\discounts параметры скидок постоянным покупателям product\discounts\discount параметры скидки product\discounts\discount\summa пороговое значение суммы покупок product\discounts\discount\percent процент скидки product\units для товаров со свободной ценой или с моделью "плати сколько хочешь" product\units\desc название единицы product\units\price цена за единицу product\units\discounts скидка в зависимости от объема покупки юнитовых товаров product\units\discounts\discount\cnt пороговый объем единиц покупок product\units\discounts\discount\desc пороговый объем единиц покупок текстом product\units\discounts\discount\percent процент скидки product\units\discounts\discount\price цена product\present подарок product\present\id идентификатор подарка product\present\name наименование подарка product\gift_commiss процент от стоимости товара, выделяемый на подарок product\options параметры товара, значения которых покупатель определяет в форме оплаты (если заданы) product\options\option модель параметра товара product\options\option\name системное id параметра product\options\option\label текстовое название параметра product\options\option\comment подсказка-описание параметра product\options\option\type тип параметра (textarea | checkbox | text | radio | select) product\options\option\separate_content признак наличия раздельного содержимого по варианту параметра товара 0 | 1 product\options\option\required признак обязательности для определения значения параметра покупателем product\options\option\modifier_visible скрыть модификатор цены product\options\option\variants набор ограниченных вариантов значений параметра (для типов checkbox,radio,select) product\options\option\variants\variant вариант product\options\option\variants\variant\value значение варианта product\options\option\variants\variant\text наименование варианта product\options\option\variants\variant\default выбран-ли вариант по умолчанию product\options\option\variants\variant\modify изменение цены товара при выборе этого варианта product\options\option\variants\variant\modify_type тип изменения цены (валюта, если абсолютное значение или %, если процентное изменение) % | USD | RUB | EUR | UAH product\options\option\variants\variant\modify_value значение изменения цены (в единицах modify_type) product\options\option\variants\variant\modify_value_default значение изменения цены в основном способе оплаты product\options\option\variants\variant\num_in_stock доступное для оплаты количество единиц товара; актуален, если установлено раздельное содержимое по варианту параметра товара Для получения этой информации нужно либо передать токен владельца, либо включить показ остатка в настройках товара. По умолчанию значение параметра недоступно. см. описание входного параметра token. product\options\option\variants\variant\visible видимость 1 - не скрыт иначе - скрыт product\options_check индикатор включенной опции "перед оплатой отправлять параметры на мой сервер для проверки" (определяется в Параметрах товара) 0 | 1 product\statistics параметры статистики по товару product\statistics\sales количество продаж int; -1 означает полностью скрыто product\statistics\sales_hidden режим отображения числа продаж 0 - продажи открыты 1 - продажи скрыты (реальное количество продаж > sales) product\statistics\refunds количество возвратов -1 означает полностью скрыто product\statistics\refunds_hidden режим отображения числа возвратов 0 - возвраты открыты 1 - возвраты скрыты (реальное количество возвратов > refunds) product\statistics\good_reviews количество положительных отзывов int; -1 означает полностью скрыто product\statistics\good_reviews_hidden режим отображения числа положительных отзывов 0 - положительные отзывы открыты 1 - положительные отзывы скрыты (реальное количество положительных отзывов > good_reviews) product\statistics\bad_reviews количество отрицательных отзывов int; -1 означает полностью скрыто product\statistics\bad_reviews_hidden режим отображения числа отрицательных отзывов 0 - отрицательные отзывы открыты 1 - отрицательные отзывы скрыты (реальное количество отрицательных отзывов > bad_reviews) product\seller продавец product\seller\id ID продавца product\seller\name название продавца (псевдоним) product\sale_info информация о распродаже product\sale_info\common_base_price базовая стоимость до распродажи product\sale_info\common_price_usd цена до распродажи. валюта: USD product\sale_info\common_price_rub цена до распродажи. валюта: RUB product\sale_info\common_price_eur цена до распродажи. валюта: EUR product\sale_info\common_price_uah цена до распродажи. валюта: UAH product\sale_info\sale_end дата окончания действия распродажи product\sale_info\sale_percent процент скидки

Получение цены с учетом входящих значений параметров и/или количества товара

xml json

URL для передачи запроса:	https://api.digiseller.com/api/products/price/calc
Метод:	GET
Заголовки запроса:	Accept: "application/json" Accept: "application/xml"
Параметры запроса:	Название Назначение Примечание product_id идентификатор товара целое число options[] перечисление пар идентификатор-значение для значимых параметров (влияющих на цену) пара идентификатор-значение указываются в виде {optionId}:{valueId}, например ?options[]=28532:41541&options[]=28530:41534 currency валюта трехзначный код метода оплаты (WMR | WMZ | ... ) amount стоимость, исходя из указанного количества единиц товара unit_cnt количество товара с нефиксированной ценой параметр является обязательным для товара с нефиксированной ценой count количество товара с фиксированной ценой
Формат ответа:	{ "retval": 0, "retdesc": "", "data": { "price": 0, "count": 0, "amount": 0, "currency": "", "commission": 0, "sale_info": { "common_base_price": 0, "sale_percent": 0 } } } <digiseller.response> <retval></retval> <retdesc></retdesc> <data> <price></price> <count></count> <amount></amount> <currency></currency> <commission></commission> <sale_info> <common_base_price></common_base_price> <sale_percent></sale_percent> </sale_info> </data> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - успех; 1 - ограничение на покупку минимального количества единиц; 2 - ограничение на покупку максимального или доступного количества единиц; 3 - ограничение способа платежа по сумме оплаты; 5 - ограничение на покупку доступного количества единиц; 33 - товар закончился или продажа приостановлена. retdesc расшифровка кода выполнения запроса data информация о цене data/price цена товара в базовой валюте data/count количество единиц товара, исходя из указанной стоимости data/amount стоимость, исходя из указанного количества единиц товара data/currency тип валюты data/commission комиссия в зависимости от способа оплаты data/sale_info информация о распродаже data/sale_info/common_base_price цена товара до распродажи data/sale_info/sale_percent процент распродажи

Отзывы о товарах

xml json

URL для передачи запроса:	https://api.digiseller.com/api/reviews?seller_id={seller_id}&product_id={product_id}&type={type}&page={page}&rows={rows}
Метод:	GET
Заголовки запроса:	Accept: application/json Accept: text/xml
Параметры запроса:	Название Назначение Примечание seller_id идентификатор продавца целое число product_id идентификатор товара целое число; необязательный параметр type тип отзыва good - положительные bad - отрицательные all - все отзывы owner_id идентификатор торговой площадки 0 - собственный магазин 1 - plati.market 1271 - ggesel 9295 - wmcenter.net page номер страницы (если не указывать номер страницы, то отображается первая страница) целое число rows количество строк на странице целое число lang язык отображения информации ru-RU (по умолчанию) или en-US
Формат ответа: пример JSON-ответа пример XML-ответа	{ "retval": 0, "retdesc": "", "totalPages": 0, "totalItems": 0, "totalGood": 0, "totalBad": 0, "reviews": [ { "id": 0, "invoice_id": 0, "owner_id": 0, "type": "", "good": 0, "name": "", "date": "", "info": "", "comment": "" } ... ] } <digiseller.response> <retval>0</retval> <retdesc/> <seller> <id></id> </seller> <product> <id></id> </product> <pages cnt=""> <num></num> <rows></rows> </pages> <reviews cnt="" good="" bad=""> <review id=""> <invoice_id></invoice_id> <owner_id></owner_id> <type></type> <date></date> <info></info> <comment></comment> <product><id></id></product> </review> ... </reviews> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса totalPages всего страниц totalItems всего отзывов totalGood всего положительных отзывов totalBad всего отрицательных отзывов seller\id идентификатор продавца переданный в запросе product\id идентификатор товара переданный в запросе pages параметры страниц атрибут cnt-количество страниц pages\num номер страницы переданный в запросе pages\rows количество строк на странице reviews параметры отзывов атрибут cnt - всего отзывов; атрибут good - всего положительных отзывов; атрибут bad - всего отрицательных отзывов reviews\review параметры отзыва атрибут id-идентификатор отзыва reviews\review\id идентификатор отзыва reviews\review\invoice_id номер заказа reviews\review\owner_id идентификатор торговой площадки 0 - собственный магазин 1 - plati.market 1271 - ggesel 9295 - wmcenter.net reviews\review\type тип отзыва good - положительный bad - отрицательный reviews\review\good идентификатор товара присутствует, только если он не был передан в запросе reviews\review\name название товара присутствует, только если он не был передан в запросе reviews\review\date дата отзыва reviews\review\info содержание отзыва reviews\review\comment комментарий продавца reviews\review\product\id идентификатор товара присутствует, только если он не был передан в запросе

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

URL для передачи запроса:	https://api.digiseller.com/api/seller-goods?token={token}
Метод:	POST
Заголовки запроса:	Content-Type: "text/xml" | "text/json" | "application/json" - формат запроса Accept: "text/xml" | "text/json" | "application/json" - формат ответа
Формат запроса XML: Формат запроса JSON:	xml json <digiseller.request> <id_seller>12126</id_seller> <order_col>cntsell</order_col> <order_dir>desc</order_dir> <rows>10</rows> <page>1</page> <currency>RUR</currency> <lang>ru-RU</lang> <show_hidden>1</show_hidden> <owner_id>null</owner_id> </digiseller.request> { "id_seller": 12126, "order_col": "cntsell", "order_dir": "desc", "rows": 10, "page": 1, "currency": "RUR", "lang": "ru-RU", "show_hidden": 1, "owner_id": null }
Параметры запроса:	Название Назначение Примечание id_seller идентификатор продавца () целое число order_col поле сортировки "name" - название "price" - цена "cntsell" - количество продаж (по умолчанию) "cntreturn" - количество возвратов "cntgoodresponses" - количество положительных отзывов "cntbadresponses" - количество отрицательных отзывов order_dir порядок сортировки "asc" - по возрастанию "desc" - по убыванию (по умолчанию) rows количество на странице целое число (по умолчанию 10, не более 1000) page номер страницы целое число (по умолчанию 1) currency тип валюты для отображения цены товара USD | RUR | EUR | UAH lang язык отображения информации ru-RU (по умолчанию) или en-US show_hidden скрытые товары; для получения скрытых товаров требуется передача GET параметра token. 0 - без скрытых товаров 1 - со скрытыми товарами 2 - только скрытые товары необязательный параметр owner_id идентификатор торговой площадки целое число необязательный параметр token Токен доступа, мин. разрешение: [ Товары ]: Просматривать Метод создания токена доступа
Кодировка ответа:	UTF-8
Формат ответа XML: пример XML-ответа Формат ответа JSON:	xml json <digiseller.response> <retval>0</retval> <id_seller>12126</id_seller> <name_seller>WYSIWYG</name_seller> <cnt_goods>16</cnt_goods> <pages>2</pages> <page>1</page> <order_col>cntsell</order_col> <order_dir>desc</order_dir> <rows cnt="10"> <row id="2080515"> <id_goods>2080515</id_goods> <name_goods>TestItem</name_goods> <info_goods> <![CDATA[Testing item]]> </info_goods> <add_info> <![CDATA[Testing item]]> </add_info> <price>9.00</price> <currency>RUR</currency> <cnt_sell>63</cnt_sell> <cnt_sell_hidden>0</cnt_sell_hidden> <cnt_return>0</cnt_return> <cnt_return_hidden>0</cnt_return_hidden> <cnt_goodresponses>1</cnt_goodresponses> <cnt_goodresponses_hidden>0</cnt_goodresponses_hidden> <cnt_badresponses>2</cnt_badresponses> <cnt_badresponses_hidden>0</cnt_badresponses_hidden> <price_usd>0.15</price_usd> <price_rur>9.00</price_rur> <price_eur>0.13</price_eur> <price_uah>3.92</price_uah> <in_stock>1</in_stock> <num_in_stock>1</num_in_stock> <visible>1</visible> <commiss_agent>1</commiss_agent> <has_discount>0</has_discount> <num_options>0</num_options> <sale_info> <common_base_price></common_base_price> <common_price_usd></common_price_usd> <common_price_rur></common_price_rur> <common_price_eur></common_price_eur> <common_price_uah></common_price_uah> <sale_end></sale_end> <sale_percent></sale_percent> </sale_info> <owner_id>0</owner_id> </row> ... </rows> </digiseller.response> { "retval": 0, "retdesc": null, "id_seller": 12126, "name_seller": "WYSIWYG", "cnt_goods": 16, "pages": 2, "page": 1, "order_col": "cntsell", "order_dir": "desc", "rows": [ { "id_goods": 2080515, "name_goods": "TestItem", "info_goods": "Testing item", "add_info": "Testing item", "price": 9, "currency": "RUR", "cnt_sell": 63, "cnt_sell_hidden": 0, "cnt_return": 0, "cnt_return_hidden": 0, "cnt_goodresponses": 1, "cnt_goodresponses_hidden": 0, "cnt_badresponses": 2, "cnt_badresponses_hidden": 0, "price_usd": 0.15, "price_rur": 9.00, "price_eur": 0.13, "price_uah": 3.92, "in_stock": 1, "num_in_stock": 1, "visible": 1, "commiss_agent": 1, "has_discount": 0, "num_options": 0, "sale_info": { "common_base_price": null, "common_price_usd": null, "common_price_rur": null, "common_price_eur": null, "common_price_uah": null, "sale_end": null, "sale_percent": null }, "owner_id": 0 }, ... ] }
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - успех коды ошибок валидации запроса: 1 - неверно задан параметр id_seller 2 - неверно задан параметр page 3 - неверно задан параметр rows 4 - неверно задан параметр currency 5 - неверно задан параметр order_col 6 - неверно задан параметр order_dir retdesc расшифровка кода выполнения запроса id_seller идентификатор продавца name_seller псевдоним (никнейм) продавца cnt_goods общее количество товаров pages количество страниц page номер текущей страницы order_col поле сортировки order_dir порядок сортировки rows список товаров магазина cnt - количество записей rows\row параметры товара id - идентификатор товара rows\row\id_goods идентификатор товара rows\row\name_goods название товара CDATA rows\row\info_goods информация о товаре CDATA rows\row\add_goods дополнительная информация CDATA rows\row\price стоимость товара rows\row\currency валюта стоимости товара RUR|USD|UAH|EUR rows\row\cnt_sell количество продаж int; -1 означает полностью скрыто rows\row\cnt_sell_hidden режим отображения числа продаж 0 - продажи открыты 1 - продажи скрыты (реальное количество продаж > cnt_sell) rows\row\cnt_return количество возвратов int; -1 означает полностью скрыто rows\row\cnt_return_hidden режим отображения числа возвратов 0 - возвраты открыты 1 - возвраты скрыты (реальное количество возвратов > cnt_return) rows\row\cnt_goodresponses количество положительных отзывов int; -1 означает полностью скрыто rows\row\cnt_goodresponses_hidden режим отображения числа положительных отзывов 0 - положительные отзывы открыты 1 - положительные отзывы скрыты (реальное количество положительных отзывов > cnt_goodresponses) rows\row\cnt_badresponses количество отрицательных отзывов int; -1 означает полностью скрыто rows\row\cnt_badresponses_hidden режим отображения числа отрицательных отзывов 0 - отрицательные отзывы открыты 1 - отрицательные отзывы скрыты (реальное количество отрицательных отзывов > cnt_badresponses) rows\row\price_usd стоимость товара в USD rows\row\price_rur стоимость товара в RUR rows\row\price_eur стоимость товара в UER rows\row\price_uah стоимость товара в UAH rows\row\in_stock доступность товара 0 - товар отсутствует 1 - товар в наличии Внимание! Для того, чтобы метод возвращал данные о товаре, даже если он закончился, убедитесь, что параметр "Товары, которые закончились" выставлен в значении "отображать" на странице настроек отображения rows\row\num_in_stock доступное для оплаты количество единиц товара Чтобы это свойство стало открытым для всех, в настройках товара необходимо включить параметр "Отображение остатка". По умолчанию значение параметра доступно только по токену владельца товара. rows\row\visible видимость 1 - не скрыт иначе - скрыт rows\row\commiss_agent партнерское вознаграждение rows\row\has_discount скидка постоянным покупателям 0 - скидка не предоставляется 1 - скидка предоставляется rows\row\num_options количество опций товара rows\row\sale_info информация о распродаже rows\row\sale_info\common_base_price базовая стоимость до распродажи rows\row\sale_info\common_price_usd цена до распродажи. валюта: USD rows\row\sale_info\common_price_rur цена до распродажи. валюта: RUR rows\row\sale_info\common_price_eur цена до распродажи. валюта: EUR rows\row\sale_info\common_price_uah цена до распродажи. валюта: UAH rows\row\sale_info\sale_end дата окончания действия распродажи rows\row\sale_info\sale_percent процент скидки rows\row\owner_id идентификатор торговой площадки

Скидка по товару

URL для передачи запроса:	http://shop.digiseller.ru/xml/shop_discount.asp
Метод:	POST
Формат запроса:	<digiseller.request> <product> <id></id> <currency></currency> </product> <email></email> </digiseller.request>
Параметры запроса:	Название Назначение Примечание product\id идентификатор товара целое число product\currency тип валюты USD, RUR, EUR, UAH или mBTC email email покупателя
Формат ответа: пример XML-ответа	<digiseller.response> <retval>0</retval> <retdesc/> <product> <price></price> <currency></currency> </product> <discount> <percent></percent> <total></total> <currency></currency> </discount> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса product\price цена с учетом скидки в указанной WM-валюте discount\percent процент скидки discount\total общая сумма покупок всегда в USD discount\currency тип валюты всегда в USD

Поиск по товарам

URL для передачи запроса:	http://shop.digiseller.ru/xml/shop_search.asp
Метод:	POST
Формат запроса:	<digiseller.request> <seller> <id></id> </seller> <products> <search></search> <currency></currency> </products> <pages> <num></num> <rows></rows> </pages> <lang></lang> </digiseller.request>
Параметры запроса:	Название Назначение Примечание seller\id идентификатор продавца целое число products\search строка поиска products\currency валюта отображения цен. необязательный параметр USD, RUB, EUR или UAH pages\num номер страницы (если не указывать номер страницы, то отображается первая страница) целое число pages\rows количество строк на странице целое число lang язык ru-RU | en-US
Формат ответа: пример XML-ответа	<digiseller.response> <retval></retval> <retdesc></retdesc> <pages cnt=""> <num></num> <rows></rows> </pages> <products cnt=""> <search></search> <currency></currency> <product> <id></id> <name></name> <price></price> <agency_fee></agency_fee> <snippets> <name></name> <info></info> </snippets> <sale_info> <common_base_price></common_base_price> <common_price_usd></common_price_usd> <common_price_rur></common_price_rur> <common_price_eur></common_price_eur> <common_price_uah></common_price_uah> <sale_percent></sale_percent> </product> ... </products> </digiseller.response>
Параметры ответа:	Название Назначение Примечание retval код выполнения запроса 0 - запрос выполнен retdesc расшифровка кода выполнения запроса pages параметры страниц атрибут cnt-количество страниц pages\num номер страницы переданный в запросе pages\rows количество строк на странице products параметры списка товаров products\search строка поиска переданная в запросе products\currency тип валюты для отображения цены, переданный в запросе products\product параметры товара products\product\id идентификатор товара products\product\name название товара products\product\price стоимость товара products\product\agency_fee партнерское вознаграждение % products\product\snippets\name название товара с найденной строкой поиска При отображении следует заменить: [[!b!]] на <b> [[!/b!]] на </b> products\product\snippets\info фрагмент(ы) описания товара с найденной строкой поиска При отображении следует заменить: [[!b!]] на <b> [[!/b!]] на </b> products\product\sale_info информация о распродаже products\product\sale_info\common_base_price базовая стоимость до распродажи products\product\sale_info\common_price_usd цена до распродажи. валюта: USD products\product\sale_info\common_price_rur цена до распродажи. валюта: RUR products\product\sale_info\common_price_eur цена до распродажи. валюта: EUR products\product\sale_info\common_price_uah цена до распродажи. валюта: UAH products\product\sale_info\sale_percent процент скидки

Быстрое получение основного изображения товара

Для получения полного перечня изображений товара необходимо использовать метод Описание товара

URL изображения товара:

//graph.digiseller.ru/img.ashx?id_d=2029463&maxlength=400 //graph.digiseller.ru/img.ashx?id_d=2029463&w=200&h=150&crop=true

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

Название Назначение Примечание id_d идентификатор товара целое число maxlength максимальная длина в пикселях по бОльшей стороне прямоугольника целое число. другой вариант задания размера — явное указание ширины и/или высоты изображения (w,h) w, h соответственно максимальная ширина, высота изображения. целые числа. могут указываться как вместе, так и один из параметров (при этом сохранится пропорция исходного изображения) crop обрезание бОльших сторон прямоугольника для образования квадрата true | false, необязательный параметр.

Создание копии описания товара (клонирование без содержимого)

URL и формат запроса	https://api.digiseller.com/api/product/clone/{product_id}?token={token}
Метод:	POST
Заголовки запроса:	Content-Type: "text/xml" | "text/json" | "application/json" Формат запроса Accept: "text/xml" | "text/json" | "application/json" - Формат ответа
Формат запроса XML Формат запроса JSON	xml json <request> <count>1</count> <categories>false</categories> <notify>false</notify> <discounts>false</discounts> <options>false</options> <comissions>false</comissions> <gallery>false</gallery> </request> { "count": 1, "categories": true, "notify": true, "discounts": true, "options": true, "comissions": true, "gallery": true }
Параметры запроса:	Название Назначение Примечание token Токен доступа, мин. разрешение: [ Товары ]: Создавать Метод создания токена доступа product_id Идентификатор товара Целое число count Количество создаваемых копий (не более 5) Целое число. по умолчанию: 1 categories Созданные копии разместить в тех же категориях, что и оригинальный товар Булевый тип. по умолчанию: false notify Копировать настройки уведомлений Булевый тип. по умолчанию: false discounts Копировать настройки скидок Булевый тип. по умолчанию: false options Копировать настройки дополнительных параметров Булевый тип. по умолчанию: false comissions Копировать настройки компенсаций Булевый тип. по умолчанию: false gallery Копировать изображения и видео Булевый тип. по умолчанию: false
Формат ответа XML: Формат ответа JSON:	xml json <result> <retval>0</retval> <retdesc>Return description</retdesc> <content> <products>220</products> <products>333</products> <products>5566</products> </content> </result> { "retval": 0, "retdesc": "", "errors": null, "content": { "products": [ 23387571, 23387572, 23387573 ] } }
Параметры ответа:	Название Назначение Примечание retval Код выполнения запроса 0 - успех 1 - ошибка при выполнении запроса. детальная информация в поле 'errors' retdesc Описание кода выполнения Детальная информация в поле 'errors' errors Код выполнения запроса Null - ошибок нет. если при выполнении запроса произошли ошибки, в этом поле будет находиться массив ошибок errors\code Код ошибки Строка errors\message Описание кода выполнения Строка content Тело ответа content\products Идентификаторы созданных товара Массив

Список товаров продавца с индивидуальным предложением

URL и формат запроса	https://api.digiseller.com/api/agents/offer?sellerId={sellerId}&onlyInStock={onlyInStock}&onlyIndividual={onlyIndividual}&productName={productName}&productId={productId}&page={page}&count={count}&token={token}
Метод:	GET
Заголовки запроса:	Accept: "application/json" - Формат ответа
Параметры запроса:	Название Назначение Примечание sellerId Идентификатор продавца Целое число productName Название товара Строка. необязательное поле productId Идентификатор товара Целое число. необязательное поле onlyInStock Только товары в наличии Булевый тип. по умолчанию: false onlyIndividual Только с индивидуальными комиссионными Булевый тип. по умолчанию: false page Номер страницы Целое число count Количество на странице Целое число (1 - 100) token Токен доступа, мин. разрешение: [ Партнерская программа ]: Индивидуальное предложение Метод создания токена доступа
Формат ответа JSON:	json { "retval": 0, "retdesc": null, "errors": null, "content": { "page": 1, "count": 11, "has_next_page": true, "has_previous_page": false, "total_count": 42, "total_pages": 4, "items": [ { "product_id": 1, "name": [ { "locale": "ru-RU", "value": "Sample name RU" }, { "locale": "en-US", "value": "Sample name EN" } ], "price": 0.04, "currency": "USD", "in_affiliate": true, "global_percent": 0, "individual_percent": 13, "last_change": null }, { "product_id": 2, "name": [ { "locale": "ru-RU", "value": "Sample name RU" }, { "locale": "en-US", "value": "Sample name EN" } ], "price": 1, "currency": "USD", "in_affiliate": false, "global_percent": 0, "individual_percent": 15, "last_change": "2019-06-05T15:56:36.023" }, .... ] } }
Параметры ответа:	Название Назначение Примечание retval Код выполнения запроса 0 - успех 1 - ошибка при выполнении запроса. детальная информация в поле 'errors' retdesc Описание кода выполнения Детальная информация в поле 'errors' errors Код выполнения запроса Null - ошибок нет. если при выполнении запроса произошли ошибки, в этом поле будет находиться массив ошибок errors\code Код ошибки Строка errors\message Описание кода выполнения Строка content Тело ответа Если при выполнении запроса произошли ошибки, это поле будет пустое content\page Страница Целое число content\count Количество Целое число content\total_count Количество всех элементов Целое число content\total_pages Всего страниц Целое число content\items Список элементов Массив content\items\product_id Идентификатор товара Целое число content\items\name Название товара Строка content\items\price Цена Дробное число content\items\currency Валюта RUB|USD|UAH|EUR content\items\in_affiliate Товар участвует в партнерской программе Булевый тип content\items\individual_percent Индивидуальный процент отчислений Целое число content\items\global_percent Процент отчислений в настройках товара Целое число content\items\last_change Последние изменения Дата и время (ISO 8601)