Laximo Web-services/Work principles

Материал из Laximo
Перейти к: навигация, поиск
Другие языки:
English • ‎русский

Принципы работы

Arc.jpeg

Соединение с сервером

С клиентского компьютера устанавливается SSL соединение с сервером каталогов.

Warning.gif При установке соединения осуществляется проверка клиентских сертификатов.

С помощью клиентского сертификата осуществляется аутентификация и авторизация пользователей. Подробнее... Так же возможна схема работы без сертификата, по подписке.

SOAP Laximo.OEM

Запросы к данным осуществляются с помощью протокола SOAP, поддерживаются следующие версии:

SOAP Laximo.AM

Запросы к данным осуществляются с помощью протокола SOAP, поддерживаются следующие версии:

QueryData

Все операции с сервисом доступны через функцию QueryData имеющую один параметр типа "строка" и возвращающую значение типа "строка".

Входной Параметр QueryData

В качестве параметра принимается список команд и их параметров. Каждая новая команда начинается с новой строки. Формат команды:

CommandName:Parameter1=Value1|Parameter2=Value2|...|ParameterN=ValueN

Такое построение формата запроса позволяет, тратясь на сетевое взаимодействие один раз, получить несколько наборов данных.

Формат результата QueryData

Функция QueryData возвращает данные в формате XML следующего вида:

<response>
<CommandName1>
<row ColumnName1="Value1" ... ColumnNameM="ValueM"/>
 
...
 
<row ColumnName1="Value1" ... ColumnNameM="ValueM"/>
</CommandName1>
 
...
 
<CommandNameN>
 
...
 
</CommandNameN>
</response>

QueryDataLogin

Функция QueryDataLogin используется при авторизации по логину с паролем. Через неё так же доступны все операции с сервисом. Функция имеет следующие параметры типа "строка":

  1. Команда
  2. Логин пользователя
  3. Контрольный код, построенный по механизму HMAC (сокращение от англ. hash-based message authentication code, хеш-код аутентификации сообщений)

Возвращаемое значение имеет тип "строка".

Входные Параметры QueryDataLogin

В качестве одного из параметров принимается список команд и их параметров. Каждая новая команда начинается с новой строки. Формат команды:

CommandName:Parameter1=Value1|Parameter2=Value2|...|ParameterN=ValueN

Такое построение формата запроса позволяет, тратясь на сетевое взаимодействие один раз, получить несколько наборов данных.

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

  1. Необходимо склеить 2 строки в одну - передаваемая в первом параметре команда + пароль пользователя.
  2. Полученная таким образом одна строка шифруется алгоритмом MD5.

Непосредственно пароль не передаётся, что увеличивает защиту системы. Сервер, при получении запроса QueryDataLogin, таким же образом строит контрольный код и сравнивает его с полученным в запросе, если коды совпали, то происходит возврат данных, иначе возвращается ошибка E_ACCESSDENIED.

Эта ошибка может иметь следующие примечания:

  • MAC check failed - Не пройдена проверка контрольного кода HMAC
  • You don`t have active subscription - У Вас нет активной подписки

Information.gif Подпиской называется активная пара логин-пароль, т.к. эта пара имеет ограниченный срок действия.

Формат результата QueryDataLogin

Функция QueryDataLogin возвращает данные в формате XML такого же вида, как и QueryData:

<response>
<CommandName1>
<row ColumnName1="Value1" ... ColumnNameM="ValueM"/>
 
...
 
<row ColumnName1="Value1" ... ColumnNameM="ValueM"/>
</CommandName1>
 
...
 
<CommandNameN>
 
...
 
</CommandNameN>
</response>


Смотрите также

Функции веб-сервисов Laximo

Общая информация

Принципы работы Безопасность Локализация каталогов Обновление каталогов Обработка ошибок Подключение сервиса
Laximo.OEM Поиск каталога ListCatalogs,GetCatalogInfo
Поиск автомобиля FindVehicleByVIN,FindVehicleByFrame, GetWizard2, GetWizardNextStep2, FindVehicleByWizard2, GetVehicleInfo, ExecCustomOperation
Поиск узла ListUnits, ListCategories, GetFilterByUnit, GetUnitInfo
Поиск деталей в узле ListDetailByUnit, ListImageMapByUnit, GetFilterByDetail
Быстрый поиск деталей ListQuickGroup, ListQuickDetail
Laximo.Aftermarket Поиск деталей FindOEM, FindReplacements, FindDetail, FindOEMCorrection
Производитель ManufacturerInfo, ListManufacturer
Библиотеки и примеры использования веб-сервисов Laximo
PHP
Скачать
PHP-библиотеку
Примеры использования библиотеки Изменение поведения и внешнего вида элементов каталогов
GuayaquilExtender
Пример переопределения стандартного поведения классов отображения данных в html
Пример получения кроссов с LaximoAftermarket
Работа с каталогами на примере отображения списка каталогов
Скачать библиотеку ASP.NET ASP.NET Guayaquil library
Варианты внедрения сервисов Laximo в 1С

Связанные категории