API – выгрузка заказов из AliExpress (xml) Структура API реализована по архитектуре REST. Коммуникация осуществляется посредством сообщений JSON, по адресам: Тестирования http://e-solution.pickpoint.ru/apitest/ Логин: apitest Пароль: apitest ИКН: 9990003041 Продуктив http://e-solution.pickpoint.ru/api/ Для корректной работы необходимо: в запросе указывать Contenttype равным “application/json”, таймаут ожидания выполнения запроса 60 секунд. Выгрузка заказов из AliExpress ...................................................................................................................... 1 Начало сессии (Login) ................................................................................................................................... 3 Завершение сессии (Logout) ..................................................................................................................... 3 Выгрузка заказов из AliExpress Получение оплаченных заказов на AliExpress. Формат JSON Необходимо от поставщика предоставить логин и пароль. В логине и пароли допустимы только латинские буквы и специальные символы. UTF-8 кодировка не поддерживается. Принцип работы. Логин и пароль отправляются в незашифрованном в виде в заголовке(header) Authorization после получения от сервера кода возврата «401 UNAUTHORIZED» Метод запроса: POST Content type: application/x-www-form-urlencoded Формат выгрузки: JSON стандартного вида. При получении ответа сервера «200 OK» выгрузка считается успешной. Содержание файла: "order": { "id": findOrderListQuery ->ordered Идентификатор заказа Ali "status": findOrderListQuery ->orderStatus Статус заказа Ali "creationDate": findOrderListQuery ->gmtCreate Дата оформления заказа "currency": findOrderListQuery ->payAmount ->currencyCode Валюта заказа "itemsTotal": findOrderListQuery ->productList.Count Количество товаров "total": findOrderListQuery ->payAmount -> amount Сумма заказа "vendor": Имя бренда "fake":{boolean} Тестовый заказ 1 "items": [ { "feedId": findOrderById ->childOrderList ->productId Product Id Ali "offerId": findOrderById ->childOrderList ->skuCode SKU Code Ali– это номер товара клиента, тот который нам давали в файлах закачки "offerName":findOrderById ->childOrderList ->productName Название товара "price": findOrderById ->childOrderList ->productPrice -> amount Цена товара "count": findOrderById ->childOrderList ->productCount Количество заказанного } ... ] "delivery": { "type": findOrderListQuery ->productList ->logisticsType Тип доставки “amount": findOrderListQuery ->productList->logisticsAmount->amount Сумма за доставку "address": { "region" : findOrderById ->receiptAddress -> province Регион доставки "country": findOrderById ->receiptAddress -> country Страна доставки "postcode": findOrderById ->receiptAddress -> zip Индекс "city": findOrderById ->receiptAddress -> city Город "address": findOrderById ->receiptAddress ->detailAddress Общий адрес "PTNumber": НомерПТ (при доставке через PickPoint) "recipient": findOrderById ->receiptAddress ->contactPerson Получатель "phone":findOrderById ->receiptAddress ->phoneNumber Телефон получателя "email": findOrderById ->buyerInfo -> email "regionru": "АлтайскийКраи",province Регион доставки по-русски "countryru": "РУ", ->countryСтрана доставки "cityru": "Банжли", ->cityГород текст по-русски (не проверяется на соответствие) "addressru": "аккепт" ->Общий адрес текст по-русски (текстовое поле, без соответствия) } "buyer": { "id": findOrderById ->buyerloginid – ИД пользователя в Али "lastName": findOrderById ->buyerInfo ->lastName Фамилия покупателя Али "firstName": findOrderById ->buyerInfo ->firstName Имя покупателя Али "phone": findOrderById ->buyerInfo ->indOrderById ->receiptAddress ->mobileNo Мобильный телефон получателя } } } 2 Начало сессии (Login) URL: /login Метод: POST Описание Команда предназначена для начала сеанса работы. В запросе отправляемся логин и пароль, в случае правильности, возвращается уникальный номер сессии, который действителен в течении установленного времени. Вся дальнейшая работа ведется на основании номера сессии. Структура запроса { “Login”:”<логин>”, “Password”:”<пароль>” } Структура ответа { “SessionId”:”<уникальный идентификатор сессии>”, “ErrorMessage”:”<текстовое сообщение об ошибке>” } Завершение сессии (Logout) URL: /logout Метод: POST Описание Команда предназначена для завершения сеанса работы. В запросе отправляется идентификатор сессии. В ответ возвращается признак успешности выполнения. Структура запроса { “SessionId”: ”<уникальный идентификатор сессии>” } Структура ответа { “Success”: <true/false> } 3