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

Пример выбора заказов по дате:
https://e-solution. pickpoint. ru/ae/odata/Orders?$filter=AeInfo/Date/Create gt cast(2017-01-25T12:04:12Z, Edm. DateTimeOffset)

Пример выбора заказов по дате:
URL: https://e-solution. pickpoint. ru/ae/odata/Orders?$filter=AeInfo/Date/Create ge cast(2017-01-25T12:04:12Z, Edm. DateTimeOffset)

Пример (Curl):

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

curl --data "client_id={clientId}&client_secret={client_secret}&grant_type=password&username={username}&password={password}" -k https://e-solution. pickpoint. ru/auth/oauth2/token

Пример:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ

Поддержка протокола OData v4 (http://www. odata. org/)

Поддерживаемые методы выборки:

$filter – фильтрация по полю (ID товара, категория товара) $orderby – сортировка (пример по data) $top - ограничение выборки $skip - пропуск начальных элементов $select - выбор необходимых элементов

  Логические операторы.

·  eq - равно

·  ne – не равно

·  gt – больше чем

·  ge – больше или равно

·  lt – меньше чем

·  le – меньше или равно

·  and – логическое «И»

·  or – логическое «Или»

·  not – логическое «Не»

ВНИМАНИЕ!

Для всех запросов, требующих авторизации необходимо добавлять заголовок Authorization, с указанием действующего токена. При отсутствии, либо истечении срока годности, токена будет возвращаться ответ: HTTP/1.1 401 Unauthorized

В каждый запрос рекомендуется добавлять следующие заголовки:

Content-Type: application/json Accept: application/json

Максимальное количество выдаваемых элементов на одну страницу: 100 штук. для заказов и 10 штук для товаров

Запрос общего количества существующих элементов в данный момент не реализован.

При работе с данными OData поддерживаются следующие http методы:

Get - получение существующего списка элементов (доступны стандартные OData-способы выборки и фильтрации данных) Get - получение одного элемента по его идентификатору Put - полная перезапись существующего элемента. Все элементы запросы должны быть помещены в Url, при отсутствии какого-либо элемента он заполняется данными по-умолчанию (при возможности). Post - добавление нового элемента. Тело запроса должно содержать только один новый элемент в формате json. Пропущенные поля (при возможности) будут заполнены значениями по-умолчанию.
Следует добавить заголовок Content-Type: application/json Patch/Merge - частичное изменение элемента. Изменяемые поля элемента следует поместить в Url запроса Delete - удаление элемента (восстановить элемент возможно по его идентификатору, передав в Put/Patch значение параметра delete=false)

Некоторые методы в некоторых разделах могут быть недоступны, при этом возвращается ответ: HTTP/1.1 405 Method Not Allowed

Используемая структура данных: https://e-solution. pickpoint. ru/ae/odata/$metadata

Варианты запроса с фильтрами: http://docs. oasis-open. org/odata/odata/v4.0/errata02/os/complete/part2-url-conventions/odata-v4.0-errata02-os-part2-url-conventions-complete. html#_Toc406398094

Работа с категориями товаров магазина. Сопоставление и изменение с категориями AliExpress.

Первоначальный список категорий AliExpress нужно скачать: http://pickpoint. ru/ali/p/deploy/goods-categoty/

Функция предназначена для получения данных о уже используемых товарных категориях магазина в AliExpress. (Можно посмотреть, что загружено и изменить категории при необходимости.)

Раздел "Работа с категориями магазинов"

URL: https://e-solution. pickpoint. ru/ae/odata/ShopCategories

Используемая структура данных: https://e-solution. pickpoint. ru/ae/odata/$metadata

Поддержка протокола OData v4 (http://www. odata. org/)

Поддерживаемые методы выборки:

$filter – фильтрация по полю (ID товара, категория товара) $orderby – сортировка (пример по data) $top - ограничение выборки $skip - пропуск начальных элементов $select - выбор необходимых элементов

Пример элемента запрос/ответ:

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#ShopCategories/$entity",

  "CategoryId": 259,                 -- идентификатор категории клиента, обязательное поле

  "ShopId": 1479387941,         -- внутренний идентификатор клиентов Pickpoint, заполняется автоматически/ используется только для отображения. При запросе на добавление поле НЕ передавать.

  "ShopOwnerId": 923,             -- внутренний идентификатор клиентов Pickpoint, заполняется автоматически При запросе на добавление поле НЕ передавать.

  "Name": "БЮСТГАЛЬТЕР",   -- название категории, обязательное поле

  "ParentId": null,                     --  идентификатор родительской категории. Не обязательное

  "AeCategory": --  элемент категории Алиэкспресс, заполняется автоматически при указании идентификатора категории Алиэкспресс. При запросе на добавление, весь блок НЕ передавать.

{                    

    "CategoryId": 31201,           -- идентификатор категории.

    "Description": "Apparel & Accessories -> Women's Clothing -> Intimates -> Bras", -- название категории

    "ParentId": 121 -- родительская категория

  },

  "AeCategoryId": 31201,           -- идентификатор категории Алиэкспресс. обязательное поле

  "AeSizeChartId": 202640020,   -- идентификатор SizeChart категории из личного кабинета Алиэкспресс. Для категорий товаров Одежда, Обувь, Ювелирные товары. Часы.

  "AeProductGroupId": 201789654       -- идентификатор ProductGroup категории магазина в Алиэкспресс. Группировка товара внутри магазина на Алиэкспресс.

}

1. Получение списка внесенных данных.

Http method: GET

URL: https://e-solution. pickpoint. ru/ae/odata/ShopCategories

Ответ:

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#ShopCategories",

  "value":

[

    {

      "CategoryId": 259,

      "ShopId": 1479387941,

      "ShopOwnerId": 923,

      "Name": "БЮСТГАЛЬТЕР",

      "ParentId": null,

      "AeCategory": {

        "CategoryId": 31201,

        "Description": "Apparel & Accessories -> Women's Clothing -> Intimates -> Bras",

        "ParentId": null

      },

      "AeCategoryId": 31201,

      "AeSizeChartId": 202640020,

      "AeProductGroupId": null

    }

  ]

}

2. Http method Get, запрос одного элемента

https://e-solution. pickpoint. ru/ae/odata/ShopCategories(259)

Получение атрибутов относящихся к конкретной категорий товаров.

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#ShopCategories/$entity",

  "CategoryId": 259,

  "ShopId": 1479387941,

  "ShopOwnerId": 923,

  "Name": "БЮСТГАЛЬТЕР",

  "ParentId": null,

  "AeCategory":

{

    "CategoryId": 31201,

    "Description": "Apparel & Accessories -> Women's Clothing -> Intimates -> Bras",

    "ParentId": null

  },

  "AeCategoryId": 31201,

  "AeSizeChartId": 202640020,

  "AeProductGroupId": null,

  "BodyTemplate": null,

  "EngBodyTemplate": null

}

3. Http method Post Добавление нового элемента раздела сопоставление категорий магазина.

https://e-solution. pickpoint. ru/ae/odata/ShopCategories

Метод для добавления категорий магазина для обозначения категорий АЕ для загрузки товара.

Пример №1

Минимально передавать необходимо следующее:

  {

  "CategoryId": 257,

  "Name": "ДЛЯ ЖЕНЩИН"

  }

Пример со всеми заполненными полями

  {

  "CategoryId": 257,

  "Name": "ДЛЯ ЖЕНЩИН",

  "ParentId": 258,

  "AeProductGroupId": 201789654,

  "AeCategoryId": 31201,

  "AeSizeChartId": 202640020

  }

Пример №2

Тело сообщения:

{

  "@odata. context": "https://e-solution. pickpoint. ru/ae/odata/$metadata#ShopCategories/$entity",

  "CategoryId": 2590,

  "ShopId": 1479387941,

  "ShopOwnerId": 923,

  "Name": "БЮСТГАЛЬТЕР",

  "ParentId": null,

  "AeCategoryId": 31201,