API для работы с AliExpress (стр. 2 )

 <stock>43</stock>  - необходимо передавать актуальные данные по стоку или зарезервированные остатки для товаров на распродаже.

 <typePrefix>Брюки</typePrefix> - не используется.

 <vendorCode>baonB294901</vendorCode> - публикуется в характеристики товара в карточке. Указывается как код модели.

 <model>Горнолыжные брюки с узором "пейсли" (арт. baonB294901)</model> - не используется.

 <description> - публикуется в поле: «Описание товара». Максимум 10 000 символов. HTML теги не используйте.

 Состав: Верхний материал: 100 Полиэстер;,Подкладочный материал:30 Полиэстер, 70 Нейлон;УтеплиПолиэстер. Производитель: Россия. Коллекция: ОСЕНЬ-ЗИМА 2014/2015. Горнолыжные брюки из материала с фирменным принтом. Важные детали: влагостойкая ткань с мембранной обработкой внутреннего покрытия, проклеенные швы,  влагостойкие молнии. Карманы активной вентиляции расположены во внутренней верхней части штанин. Регулируемые по высоте подтяжки отстегиваются. Нижние части штанин дополнены вставками-расширителями на молнии, снегоудерживающие манжеты дополнены фиксаторами. Пояс имеет шлевки для ремня, карманы на молнии: два сзади и два по бокам.

 Влагостойкость (мм водного столба): 8000 Пароиспарение (гр. м.кв./24 часа): 6000

 Длина штанины по внутреннему шву (S): 81 см.

 </description>

<keywords> keywords </keywords > - перечень ключевых слов для поиска. Только на английском. Разделитель - пробел. Ограничения 400 символов.

  <country_of_origin>Россия</country_of_origin> - страна производителя товара.

  <param name="Размер ">S</param> - параметры должны соответствовать значению характеристик товаров. см пункт «Получение характеристик товаров»

  <param name="Длина">100</param> - обязательное поле. Размер отправления с товаром

  <param name="Ширина">100</param> - обязательное поле. Размер отправления с товаром

  <param name="Высота">100</param> - обязательное поле. Размер отправления с товаром

  <param name="Вес">1</param> - обязательное поле. Измерение в килограммах. Размер отправления с товаром

  <param name="Цвет">Синий</param> - одно значение цвета.

  <param name="Пол">Женский</param>

<param name="Бренд">Adidas</param> - обязательно поле. Название бренда, зарегистрированного и прикрепленного к магазу в АЕ

  <param display=”description” name="Обхват груди">Женский</param> - строка с данным значением дублируется в поле «Описание товара».

  <param name="Возраст">Взрослый</param>

<param name=”Материал”> вискоза </param> - материал, без указания % составляющего.
<param name=”Материал”> нейлон </param>- материал, без указания % составляющего.

<param name="Состав">Верхний материал: 100 Полиэстер;,Подкладочный материал:30 Полиэстер, 70 Нейлон;УтеплиПолиэстер</param>

  <param name="oldPrice">6799</param>

  <oldprice>6799</oldprice>

  </offer>

</offers>

ОБРАТИТЕ ВНИМАНИЕ(!)

1.  Если не заданы параметры упаковки (длина, ширина, высота, вес), используются стандартные:

·  Длина: 30 см

·  Ширина: 20 см

·  Высота: 5 см

·  Вес: 1 кг

2.  Если добавить в описание любого параметра атрибут display=”description”, то данный параметр будет отображаться в описании товара.

3.  Для каждого размера должны быть указаны все возможные цвета. Если товар в каком-нибудь цвете для какого-то размера отсутствует, необходимо передать значение stock=0. (Пример: 1 товар, 3 размера, 5 цветов – должно быть 15 SKU)

4.  Все параметры должны быть указаны в единичном значении и без дублей полей. Исключение поле «Материал» - данное поле можно передавать несколькими строками.

5.  group_id – Для корректного соотнесения всех вариантов с одной моделью необходимо в описании каждого товарного предложения использовать атрибут group_id.

Регистрация магазина в системе

Перед началом работы с сервером авторизации, магазин должен зарегистрироваться в системе используя ранее полученные временные имя пользователя и пароль.

Процесс регистрации

Url: https://e-solution. pickpoint. ru/auth/api/clients/register

Http method: POST

Content-Type: application/x-www-form-urlencoded

Данные формы:

username - временное имя пользователя password - временный пароль email - email клиента (используется для изменения пароля и уведомлений), необязательное поле phone - телефон клиента, необязательное поле

Формат ответа:

HTTP/1.1 201 Created

Content-Type: application/json; charset=utf-8

{

  "client_id": "0c4dae0d8e784e94890c6238adb43533",                              -- client_id

  "client_secret": "3-s7acZ9Or12ilZneRc61aTOglNf1s80XkT4HMyi-LE",      -- client_secret

  "username": "detstvo",                                                                              -- username

  "password": "***same password***",                                                         -- пароль не указывается для безопасности, равен временному паролю

  "shopName": "Pickpoint",                                                                           -- имя магазина

  "success": true                      

}

Формат ответа в случае ошибки:

HTTP/1.1 400 Bad Request

Content-Type: application/json; charset=utf-8

{

  "message": "Client already registered"                                                     -- текст ошибки

}

Возможные ошибки:

Unknown user name or bad password  -- неверное имя пользователя или пароль Aliexpress account not created              -- аккаунт для доступа в АЕ не создан Client already registered                        -- клиент уже зарегистрирован

Пример (Curl):

Curl (https://curl. haxx. se/download. html)

curl --data "username=loreal_rus&password=rus_loreal295" - k https://e-solution. pickpoint. ru/auth/api/clients/register/

Авторизация в магазина системе

Для поддержки авторизации множества систем: API/Control panel/Личный кабинет и др. стало необходимым выделить авторизацию в отдельный сервис.

Для обеспечения низкого порога входа для доступа к данным, сервис авторизации должен поддерживать один из стандартных протоколов авторизации. Выбран протокол: The OAuth 2.0 Authorization Framework (http://tools. ietf. org/html/rfc6749)

Необходима поддержка только одного типа авторизации: Resource Owner Password Credentials(http://tools. ietf. org/html/rfc6749#section-4.3)

Объект обмена требованиями(claim) пользователя между партнерами: JSON Web Token (https://jwt. io), RFC 7519(https://tools. ietf. org/html/rfc7519)

Параметры авторизации

ClientId, ClientSecret - должны создаваться для каждого партнёра User, Password - используются логин и пароль оператора Время жизни токена авторизации - 24 часа RefreshToken - не используются Время жизни ClientSecret – бессрочно.

Процесс авторизации

Url авторизации: https://e-solution. pickpoint. ru/auth/oauth2/token

Http Метод: POST

Content-Type: application/x-www-form-urlencoded

Данные формы:

client_id - тип данных GUID, уникальный id клиента, предоставляется после процедуры «Регистрация» client_secret - тип данных Base64 encoded signed integer key, уникальный ключ клиента, используется для подписи и валидации запросов, предоставляется после процедуры «Регистрация». Срок действия - бессрочный. grant_type - тип авторизации, в данный момент необходимо передавать слово "password" username - логин оператора клиента password - пароль оператора клиента

Формат ответа:

·  Content-Type: application/json;charset=UTF-8

·  JSon, содержащийся в теле ответа, содержит следующие поля

·  access_token - токен, используемый при авторизации в API. срок действия 24 часа

·  token_type - тип токена, всегда "bearer"

·  expires_in - время жизни токена, в секундах

Пример:

Запрос
client_id={testGuid}&client_secret={base64Encoded}&grant_type=password&username=test&password=test Ответ:
{"access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ","token_type":"bearer","expires_in":86399}

Для авторизации необходимо добавлять в Header запросов заголовок Authorization, содержащий следующие данные: "{Token_type} {Token}"