| ООО "РОЛИС" предлагает своим клиентам простой и эффективный способ получения оперативной информации, который может быть легко интегрирован с Вашими приложениями и информационными системами, используя разработанные нами Web-сервисы. Web сервисы - это технология построения распределенных систем. Она основана на открытых стандартах - XML, SOAP, WSDL и HTTP. Данная технология позволяет легко интегрировать приложения, независимо от их платформы и языка разработки. При использовании Web-сервисов вы получаете данные, которые могут быть легко интегрированы в любое ваше приложение. В этом разделе можно найти описание интерфейса для работы с Web-сервисами, а также примеры их использования. Важно: перед первым использованием логина, предназначенного для выполнения запросов через веб-сервисы, необходимо зайти под ним через браузер и сменить пароль.
Общие интерфейсыВнимание: точные наименования методов и имен параметров сверять с WSDL файлом. Получение списка терминалов (TerminalList) Запрашивается операция TerminalList. В результате клиенту возвращается массив структур содержащих следующие поля:
Возвращаемые коды терминалов являются постоянными, и в случае работы клиентского ПО с каким-либо конкретным терминалом могут быть один раз заданы, в процессе настройки ПО. Получение информации о балансе и пороге отключения (Balance) Данная операция позволяет отслеживать состояние счета. Возвращаемый результат содержит следующие поля:
Интерфейс для получения ДУОперация получения ДУ состоит из двух этапов. На первом этапе по номеру контейнера запрашивается список документов учета, ему соответствующих (операция TDUInfoList). В возвращаемых данных содержится код документа учета, по которому можно запросить непосредственно сам документ в нужном представлении (операция TDURepresentation). Получение списка документов учета по контейнеру (TDUInfoList) Данная операция позволяет получить список существующих документов учета для указанного контейнера. Операция принимает на вход два обязательных параметра:
На выходе возвращается список структур, состоящих из следующих полей:
Получение документа учета (TDURepresentation) Для получения непосредственно документа учета используется операция TDURepresentation. Данная операция принимает три входных параметра:
Ответ операции состоит из двух структур (TDUData и TDURepresentation). Структура TDUData содержит общую информацию о полученном документе учета, а именно:
Структура TDURepresentation содержит запрошенное представление документа учета и состоит из следующих полей:
Интерфейс для работы с предоставлением информации о контейнере в импортеДобавление пользовательской группы (ImportEventsGroupAdd) Данная операция предназначена для создания дополнительных групп. Операция на вход принимает один параметр:
В случае успешного выполнения возвращается целое число, соответствующее коду вновь добавленной группы. Удаление пользовательской группы (ImportEventsGroupDelete) Удаляет группу, если в ней не содержится подписанных контейнеров (если группа пуста). В противном случае возвращает ошибку. Данная операция принимает на вход один параметр:
Возвращаемых параметров нет. Переименование пользовательской группы (ImportEventsGroupRename) Переименовывает (меняет название) пользовательской группы. Содержимое группы не затрагивается. Данная операция принимает на вход два параметра:
Возвращаемых параметров нет. Подписка на контейнер (ImportEventsContainerSubscribe) Производит подписку на события по указанному контейнеру. Входные параметры:
Возвращает код подписанного контейнера(числовой) Отмена подписки на контейнер (ImportEventsContainerUnsubscribe) Отменяет подписку на контейнер. Входные параметры:
Возвращаемых параметров нет. Изменение пользовательской группы у подписанного контейнера (ImportEventsContainerGroupChange) Изменяет пользовательскую группу, в которой числится указанный контейнер. Входные параметры:
Возвращаемых параметров нет.
Интерфейс для получения расписания досмотровых операцийРасписание досмотров (ExamRequestTimes) Возвращает расписание досмотровых операций на терминале. Входные параметры:
Возвращает xml представление (raw xml) расписания досмотровых операций на указанном терминале.
Ссылки: |