====== ОПР ====== в рамках разработки ОПР Калибр мы подготовили приёмник, а также предложение по составу обмениваемой информации. ^№ п/п^Наименование обмена^Инициатор^Параметры обмена^ |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 ===== Протокол обмена №3 ===== Рис.1 Протокол обмена №1. {{ :artsec:image_opr.png|}} -- С уважением, Долгов Илья менеджер проектов ООО "Интернет-системы" РАЗРАБОТКА, ПОДДЕРЖКА и РАСКРУТКА САЙТОВ -- тел. +7 904 001 00 55 mailto:proekt@inetsys.ru skype:dolgov_ilija http://inetsys.ru Пожелания: вместо unix_time использовать нормальный формат даты-времени. также при наличии ид точки проезда явное указание направления избыточно, можно ограничиться или одним или другим. Вопросы, не получившие освещения в этом документе: - не рассмотрены различные ситуации валидации сообщения об оплате. Пример: карта может быть неизвестной, неактивной, служебной или находиться не на территории. В ответе эти данные должны быть. - очень желательно где-нибудь подробно описать алгоритм использования информации об оплате. наиболее интересные моменты - в течение которого времени разрешен выезд после получения данных об оплате. надо явно указать приоритет номера карты и то, что ГРЗ указывается справочно и при анализе данных не используется. что при любом проезде текущая информация по оплате данной карты становится недействительной. - вышеупомянутый документ должен содержать правила обработки разрешений на выезд (так правильнее говорить вместо слова "платежей") из всех имеющихся в настоящее время источников с учетом их возможной специфики. - при описании запроса истории проездов упомянут массив, то есть следует понимать, что это должна быть выходная информация, а вот входные параметры не описаны.