Инструменты пользователя

Инструменты сайта


ru:api_solutions:api_good_list_seller

API-интерфейс #2: Список товаров продавца

API-интерфейс для отправки клиентского XML-запроса и получение XML/JSON ответа от API сервера со списком цифровых товаров продавца.


XML-запрос (пример)

URL для передачи запроса
https://axefile.com/api/goods_user/
Метод POST
Запрос
<?xml version="1.0" encoding="UTF-8"?>
<request api_version="1.0">
    <merchant_data>
        <merchant>120</merchant>
        <signature>J6NDWTCOPZ2GLD3GGODXIYJESHBUGT13</signature>
    </merchant_data>
    <data>
        <seller>145</seller>
        <page>0</page>
        <rows>25</rows>
        <currency>usd</currency>
        <language>en</language>
        <order>dateDESC</order>
        <format>xml</format>
    </data>
</request>

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

Название Статус Описание Тип данных
merchantrequiredУникальный идентификатор продавца(агента), полученный при регистрации (можно посмотреть в личном кабинете) (integer)
signaturerequiredСигнатура запроса рассчитывается следующим образом (PHP):
$sign=sha1(md5($merchant.$shop_hash))

где
$merchant - уникальный идентификатор продавца (агента)
$shop_hash - секретный ключ, который можно получить здесь: https://axefile.com/partner/referal

(string)
sellerrequiredУникальный идентификатор продавца товаров (integer)
pageoptionalЗначение указывает с какой страницы выводить результаты. По умолчанию: 0 (integer)
rowsoptionalКоличество строк на странице. По умолчанию: 25 (integer)
currencyoptionalВ какой валюте выводить стоимость товара. Доступные валюты: uah,usd,rub,eur. По умолчанию: usd (string)
languageoptionalНа каком языке выводить название товара (ru - русский, en - английский). По умолчанию: en (string). Результат будет выводиться только в том случае, если имеется название у товара на запрашиваемом языке. Например, если установлено запрашиваемое значение «ru», а название по-русски отсутствует, а по-английски название присутствует, то результат будет отсутствовать и наоборот. (string)
orderoptionalПорядок вывода результата:
dateASC - дате - от старых к новым
dateDESC - дате - от новых к старым
titleASC - названию А - Я
titleDESC - названию Я - А
priceASC - цене - возрастанию
priceDESC - цене - убыванию
По умолчанию: дате добавления - dateDESC
Если параметр не указан, то сортируется по дате добавления
Значения чувствительны к регистру.
(string)
formatoptionalФормат ответа на запрос (xml/json). По умолчанию: xml (string)

XML-ответ на запрос (пример)

<?xml version="1.0" encoding="UTF-8"?>
<response api_version="1.0">
  <goods cnt="2">
    <good id="0">
      <id>1222</id>
      <title>Русский релиз Discuz X3.1 20140301 от TEAM Chinascript.ru</title>
      <price>250.00</price>
      <currency>usd</currency>
      <type>0</type>
      <unique>1</unique>
      <good_num>1</good_num>
      <size_file>15434840</size_file>
      <mime>zip</mime>
      <hash_md5>da77efae02883c240c12f177f5a5f212</hash_md5>
      <sales>0</sales>
      <seller>145</seller>
      <agent>10</agent>
      <gift>5</gift>
      <return>0</return>
      <moneyback>30</moneyback>
      <id_category>409</id_category>
      <date_create>1432646361</date_create>
      <cnt_reviews_negative>0</cnt_reviews_negative>
      <cnt_reviews_positive>0</cnt_reviews_positive>
    </good>
    <good id="1">
      <id>1220</id>
      <title>Релиз торгового молла ECMall от 26.02.2011</title>
      <price>0.18</price>
      <currency>usd</currency>
      <type>0</type>
      <unique>0</unique>
      <good_num>0</good_num>
      <size_file>16780296</size_file>
      <mime>zip</mime>
      <hash_md5>66b9b573df99294e7f40c24eda1d5c51</hash_md5>
      <sales>47</sales>
      <seller>145</seller>
      <agent>5</agent>
      <gift>5</gift>
      <return>0</return>
      <moneyback>30</moneyback>
      <id_category>409</id_category>
      <date_create>1432288354</date_create>
      <cnt_reviews_negative>0</cnt_reviews_negative>
      <cnt_reviews_positive>0</cnt_reviews_positive>
    </good>
  </goods>
  <status status_descr="Successful sending a response from the API-server">success</status>
  <cnt_goods>2</cnt_goods>
  <username>Андрей Акишин</username>
  <shop>Фортуна</shop>
</response>

JSON-ответ на запрос (пример)

//Ответ приходит в JSON формате, но для визуализации мы его выводим в виде массива данных (PHP):
print_r(json_decode($json_data, TRUE);)
Array
(
    [goods] => Array
        (
            [0] => Array
                (
                    [id] => 1222
                    [title] => Русский релиз Discuz X3.1 20140301 от TEAM Chinascript.ru
                    [price] => 250.00
                    [currency] => usd
                    [type] => 0
                    [unique] => 0
                    [good_num] => 0
                    [size_file] => 15434840
                    [mime] => zip
                    [hash_md5] => da77efae02883c240c12f177f5a5f212
                    [sales] => 0
                    [seller] => 145
                    [agent] => 10
                    [gift] => 5
                    [return] => 0
                    [moneyback] => 30
                    [id_category] => 409
                    [date_create] => 1432646361
                    [cnt_reviews_negative] => 0
                    [cnt_reviews_positive] => 0
                )
 
            [1] => Array
                (
                    [id] => 1220
                    [title] => Релиз торгового молла ECMall от 26.02.2011
                    [price] => 0.18
                    [currency] => usd
                    [type] => 0
                    [unique] => 0
                    [good_num] => 0
                    [size_file] => 16780296
                    [mime] => zip
                    [hash_md5] => 66b9b573df99294e7f40c24eda1d5c51
                    [sales] => 47
                    [seller] => 145
                    [agent] => 5
                    [gift] => 5
                    [return] => 0
                    [moneyback] => 30
                    [id_category] => 409
                    [date_create] => 1432288354
                    [cnt_reviews_negative] => 0
                    [cnt_reviews_positive] => 2
                )
 
        )
 
    [status] => success
    [status_descr] => Successful sending a response from the API-server
    [cnt_goods] => 2
    [username] => Андрей Акишин
    [shop] => Фортуна
)

Параметры ответа (XML/JSON)

Название Описание Тип данных
goods/ Товары продавца. Атрибут cnt - общее кол-во товаров
goods/good/ Товар продавца, выводимый в цикле. Атрибут id - порядковый номер
goods/good/idID товара(integer)
goods/good/titleНазвание товара. Может выводиться в одном из языков (ru - русский, en - английский), который был указан в запросе language. (string)
goods/good/priceСтоимость товара в указанной валюте, которая была указана в запросе (пример: 250.00) (decimal(12,2))
goods/good/currencyВалюта товара, которая была указана в запросе. Возможные значения: uah,usd,rub,eur (string)
goods/good/typeТип товара: 0 - архивный файл, 1 - текст произвольный, 2 - код произвольный в одну строку, 3 - код 16-значный (integer)
goods/good/uniqueУникальность товара (единоразовая продажа). 0 - продается неограниченное количество раз, 1 - продается только один раз (integer)
goods/good/good_numКоличество единиц товара, доступных к продаже (integer)
goods/good/size_fileРазмер файла в байтах. Выводится если параметр type == 0 (архивный файл), при остальных значениях выводится: 0 (integer)
goods/good/mimeMIME-тип товара (подробнее. Выводится только при параметре товара type == 0 (архивный файл), при остальных значениях выводится: null (string)
goods/good/hash_md5Расчет контрольной суммы файла алгоритмом MD5. Выводится только при параметре товара type == 0 (архивный файл), при остальных значениях выводится: null (string)
goods/good/salesКоличество продаж товара (integer)
goods/good/sellerID продавца товара (integer)
goods/good/agentПартнерское вознаграждение агенту за продажу этого товара, указывается в процентах (%). (integer)
goods/good/giftБонус покупателю процент (%) от стоимости товара за положительный отзыв о товаре (integer)
goods/good/returnКоличество возвратов товара (integer)
goods/good/moneybackКол-во дней периода действия для возврата оплаченных средств покупателю (integer)
goods/good/id_categoryID категории товара (integer)
goods/good/date_createДата добавления товара в формате *unix time stamp (integer)
goods/good/cnt_reviews_negativeКоличество отрицательных отзывов товара (integer)
goods/good/cnt_reviews_positiveКоличество положительных отзывов товара (integer)
status (XML)Статус ответа от API сервера: success - успешное выполнение, error - ошибка выполнения. Для более полной расшифровки в теге передается XML-атрибут @status_descr - описание статуса (string)
status (JSON)Статус ответа от API сервера: success - успешное выполнение, error - ошибка выполнения. (string)
status_descr (JSON)Описание статуса ответа от API сервера. (string)
cnt_goodsКоличество товаров продавца (integer)
usernameФамилия, имя продавца (string)
shopНазвание магазина (string)

Для получения и использования API-решений Вам необходимо авторизоваться, используя форму входа для партнеров/продавцов, чтобы получить серетный ключ. Если вы еще не зарегистрированы как партнер, то можете сделать это прямо сейчас: перейти к регистрации.

ru/api_solutions/api_good_list_seller.txt · Последние изменения: 2015/09/26 11:01 (внешнее изменение)