Это старая версия документа.
в рамках разработки ОПР Калибр мы подготовили приёмник, а также предложение по составу обмениваемой информации.
№ п/п | Наименование обмена | Инициатор | Параметры обмена |
---|---|---|---|
1 | Сообщение о факте выезда | АПО | Адрес приемника: http://auto.isdemo.ru/soap/entry/ файл с описанием веб-сервисов http://auto.isdemo.ru/soap/entry/entry.wsdl где: * card_number - номер карты * time - время ( в формате unix time ) * waypoint - id/название терминала * direction - направление: въезд/выезд (допустимые значение «in» и «out») |
2 | Сообщение о факте оплаты | ОПР | Для отправки с сайта информации об оплате (обмен №2) нужно создать сервер soap который будет принимать следующие параметры: * номер карты (цифры) * сумма оплаты (цифры) * время оплаты (unix timestamp) * номер заказа (цифры) * номер авто (строка) при успехе в result пишем «ok» |
3 | Запрос журнала проездов | ОПР | Для запроса с сайта на получение списка въездов/выездов (обмен №3) нужно подготовить точно такой же протокол, что и в обмене №1 (см. рис. 1) только обернув перечень в коллекцию. где: * card_number - номер карты * time - время ( в формате unix time ) * waypoint - id/название терминала * direction - направление: въезд/выезд (допустимые значение «in» и «out») |
Для авторизации будем использовать Basic authorization (логин + пароль)
При запросах на наш сервер используем следующие логин и пароль:
логин: opr_soap
пароль: 3uLHVmqbkSfHSqZzb86E
– С уважением, Долгов Илья менеджер проектов ООО «Интернет-системы» РАЗРАБОТКА, ПОДДЕРЖКА и РАСКРУТКА САЙТОВ – тел. +7 904 001 00 55 mailto:proekt@inetsys.ru skype:dolgov_ilija http://inetsys.ru
Пожелания: вместо unix_time использовать нормальный формат даты-времени. также при наличии ид точки проезда явное указание направления избыточно, можно ограничиться или одним или другим. Вопросы, не получившие освещения в этом документе: - не рассмотрены различные ситуации валидации сообщения об оплате. Пример: карта может быть неизвестной, неактивной, служебной или находиться не на территории. В ответе эти данные должны быть. - очень желательно где-нибудь подробно описать алгоритм использования информации об оплате. наиболее интересные моменты - в течение которого времени разрешен выезд после получения данных об оплате. надо явно указать приоритет номера карты и то, что ГРЗ указывается справочно и при анализе данных не используется. что при любом проезде текущая информация по оплате данной карты становится недействительной. - вышеупомянутый документ должен содержать правила обработки разрешений на выезд (так правильнее говорить вместо слова «платежей») из всех имеющихся в настоящее время источников с учетом их возможной специфики. - при описании запроса истории проездов упомянут массив, то есть следует понимать, что это должна быть выходная информация, а вот входные параметры не описаны