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

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


ru:api_solutions:api_seller_data

API-интерфейс #1: Данные продавца

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


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

URL для передачи запроса
https://axefile.com/api/user_info/
Метод 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>
        <format>xml</format>
    </data>
</request>

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

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

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

(string)
sellerrequiredУникальный идентификатор продавца товаров (integer)
formatoptionalФормат ответа на запрос (xml/json). По умолчанию: xml (string)

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

<?xml version="1.0" encoding="UTF-8"?>
<response api_version="1.0">
  <seller>
    <id>145</id>
    <username>Андрей Акишин</username>
    <first_name>Андрей</first_name>
    <last_name>Акишин</last_name>
    <shop>Фортуна</shop>
    <phone>380681468300</phone>
    <email>[email protected]</email>
    <country_name>Украина</country_name>
    <country_code>UA</country_code>
    <status>1</status>
    <count_goods>4</count_goods>
    <icq>9331103</icq>
    <skype>Chinascript.ru</skype>
    <user_rating>101.00000000</user_rating>
    <sales>56</sales>
    <created_on>1432223276</created_on>
    <cnt_reviews_negative>0</cnt_reviews_negative>
    <cnt_reviews_positive>1</cnt_reviews_positive>
  </seller>
  <status status_descr="Successful sending a response from the API-server">success</status>
</response>

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

//Ответ приходит в JSON формате, но для визуализации мы его выводим в виде массива данных (PHP):
print_r(json_decode($json_data, TRUE);)
Array
(
    [seller] => Array
        (
            [id] => 145
            [username] => Андрей Акишин
            [first_name] => Андрей
            [last_name] => Акишин
            [shop] => Фортуна
            [phone] => 380681468300
            [email] => anrysys@yandex.ua
            [country_name] => Украина
            [country_code] => UA
            [status] => 1
            [count_goods] => 4
            [icq] => 9331103
            [skype] => Chinascript.ru
            [user_rating] => 101.00364067
            [sales] => 56
            [created_on] => 1432223276
            [cnt_reviews_negative] => 0
            [cnt_reviews_positive] => 3
        )
 
    [status] => success
    [status_descr] => Successful sending a response from the API-server
)

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

Название Описание Тип данных
seller/idУникальный идентификатор продавца(integer)
seller/usernameФамилия и имя продавца (string)
seller/first_nameИмя продавца (string)
seller/last_nameФамилия продавца (string)
seller/shopНазвание магазина продавца (string)
seller/phoneНомер телефона продавца (integer)
seller/emailЭлектронный адрес продавца (string)
seller/country_nameНазвание страны (пример: Украина, Россия) (string)
seller/country_codeКод страны в буквенном индексе (пример: UA, RU) (string)
seller/status0 - не активирован, 1 - работает, 8 - блокировка продаж, 9 - блокировка аккаунта (integer)
seller/count_goodsКоличество товаров продавца (integer)
seller/icqICQ продавца (integer)
seller/skypeSkype продавца (string)
seller/user_ratingРейтинговый балл продавца (пример: 101.00000000) (decimal(12,8))
seller/salesКоличество продаж продавца (integer)
seller/created_onДата регистрации в формате *unix time stamp (integer)
seller/cnt_reviews_negativeКоличество отрицательных отзывов (integer)
seller/cnt_reviews_positiveКоличество положительных отзывов (integer)
status (XML)Статус ответа от API сервера: success - успешное выполнение, error - ошибка выполнения. Для более полной расшифровки в теге передается XML-атрибут @status_descr - описание статуса (string)
status (JSON)Статус ответа от API сервера: success - успешное выполнение, error - ошибка выполнения. (string)
status_descr (JSON)Описание статуса ответа от API сервера. (string)

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

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