API партнера
Используя предоставляемые нами XML-интерфейсы, вы можете воссоздать на своем сайте каталог товаров bitma.ru, выполненный в вашем дизайне.
Более подробно ознакомиться с особенностями партнерской программы bitma.ru вы можете в Описании.
XML интерфейсы:
Cписок товаров в разделе
| URL запроса | https://plati.io/xml/goods.asp |
|---|---|
| Метод: | POST |
| Данные запроса: |
<digiseller.request>
<guid_agent></guid_agent>
<id_section></id_section>
<lang>ru-RU</lang>
<encoding></encoding>
<page></page>
<rows></rows>
<currency></currency>
<order></order>
</digiseller.request>
|
Параметры запроса
| Название | Назначение | Примечание |
|---|---|---|
| guid_agent | ваш партнерский UID | Вам необходимо авторизоваться или зарегистрироваться как партнер, используя форму входа справа. |
| id_section | идентификатор категории | целое число |
| lang | ru-RU | en-US | |
| encoding | utf-8 | |
| page | номер страницы (если не указывать номер страницы, то отображается первая страница) | целое число |
| rows | количество единиц на странице (не более 500) | целое число |
| currency | тип валюты для отображения цены товара | USD | RUR | EUR | UAH |
| order | способ сортировки товаров |
name — названию А - Я nameDESC — названию Я - А price — цене - убыванию priceDESC — цене - возрастанию rating - рейтингу продавца - возрастанию ratingDESC - рейтингу продавца - убыванию если не указывать, то сортируются по рейтингу продавца и сумме, заплаченной за рекомендуемые |
Формат ответа
| Пример ответа |
<digiseller.response>
<retval></retval>
<retdesc></retdesc>
<id_section></id_section>
<name_section></name_section>
<cnt_goods></cnt_goods>
<pages></pages>
<page></page>
<order></order>
<rows cnt="">
<row id="">
<id_goods></id_goods>
<name_goods></name_goods>
<price></price>
<currency></currency>
<discount></discount>
<gift></gift>
<reward></reward>
<id_seller></id_seller>
<name_seller></name_seller>
<rating></rating>
<summpay></summpay>
<statistics>
<cnt_sell></cnt_sell>
<cnt_return></cnt_return>
<cnt_goodresponses></cnt_goodresponses>
<cnt_badresponses></cnt_badresponses>
</statistics>
<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>
</sale_info>
</row>
</rows>
</digiseller.response>
|
|---|
Параметры ответа
| Название | Назначение | Примечание |
|---|---|---|
| retval | код выполнения запроса |
0 — запрос успешно отработан -1 — отсутствует или неверно задан параметр (guid_agent) -2 — отсутствует или неверно задан параметр (id_section) -3 — отсутствует или неверно задан параметр (page) -4 — отсутствует или неверно задан параметр (rows) 4 — раздел не найден |
| retdesc | описание кода выполнения | |
| id_section | идентификатор категории | |
| name_section | название категории | |
| cnt_goods | количество товаров в категории | |
| pages | всего страниц | |
| page | номер страницы | |
| order | выбранный способ сортировки | |
| rows | параметры строк | |
| rows \ row | параметры строки | id — порядковый номер строки |
| rows \ row \ id_goods | идентификатор товара | |
| rows \ row \ name_goods | название товара | |
| rows \ row \ price | цена | |
| rows \ row \ currency | тип валюты | |
| rows \ row \ discount | скидка | yes | no |
| rows \ row \ gift | подарочная карта | yes | no |
| rows \ row \ reward | процент | партнерское вознаграждение при продаже товара (%) |
| rows \ row \ id_seller | идентификатор продавца | |
| rows \ row \ name_seller | краткое имя продавца | |
| rows \ row \ rating | рейтинг продавца | |
| rows \ row \ summpay | сумма, оплаченная за рекомендуемые в $ | |
| rows \ row \ statistics | статистика по товару | |
| rows \ row \ statistics \ cnt_sell | продаж | |
| rows \ row \ statistics \ cnt_return | количество возвратов | |
| rows \ row \ statistics \ cnt_goodresponses | положительных отзывов | |
| rows \ row \ statistics \ cnt_badresponses | отрицательных отзывов | |
| 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_percent | процент скидки |