Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
artsec:опр [10.06.2019 07:36] buh |
artsec:опр [14.06.2019 07:30] (текущий) buh [Протокол обмена №3] |
||
---|---|---|---|
Строка 4: | Строка 4: | ||
|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")\\ | | |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"| | |2|Сообщение о факте оплаты|ОПР|Для отправки с сайта информации об оплате (обмен №2) нужно создать сервер soap который будет принимать следующие параметры:\\ * номер карты (цифры)\\ * сумма оплаты (цифры)\\ * время оплаты (unix timestamp)\\ * номер заказа (цифры)\\ * номер авто (строка)\\ при успехе в result пишем "ok"| | ||
- | |3|Запрос журнала проездов|ОПР|Для запроса с сайта на получение списка въездов/выездов (обмен №3) нужно подготовить точно такой же протокол, что и в обмене №1\\ только обернув перечень в коллекцию.\\ где:\\ * card_number - номер карты\\ * time - время ( в формате unix time )\\ * waypoint - id/название терминала\\ * direction - направление: въезд/выезд (допустимые значение "in" и "out")| | + | |3|Запрос журнала проездов|ОПР|Для запроса с сайта на получение списка въездов/выездов (обмен №3) нужно подготовить точно такой же протокол, что и в обмене №1 (см. рис. 1)\\ только обернув перечень в коллекцию.\\ где:\\ * card_number - номер карты\\ * time - время ( в формате unix time )\\ * waypoint - id/название терминала\\ * direction - направление: въезд/выезд (допустимые значение "in" и "out")| |
- | ====== Авторизация ====== | + | ===== Авторизация ===== |
Строка 18: | Строка 18: | ||
===== Протокол обмена №3 ===== | ===== Протокол обмена №3 ===== | ||
- | + | Рис.1 Протокол обмена №1. | |
{{ :artsec:image_opr.png|}} | {{ :artsec:image_opr.png|}} | ||
Строка 35: | Строка 35: | ||
skype:dolgov_ilija | skype:dolgov_ilija | ||
http://inetsys.ru | http://inetsys.ru | ||
+ | |||
+ | Пожелания: вместо unix_time использовать нормальный формат даты-времени. также при наличии ид точки проезда явное указание направления избыточно, можно ограничиться или одним или другим. | ||
+ | |||
+ | Вопросы, не получившие освещения в этом документе: | ||
+ | |||
+ | - не рассмотрены различные ситуации валидации сообщения об оплате. Пример: карта может быть неизвестной, неактивной, служебной или находиться не на территории. В ответе эти данные должны быть. | ||
+ | - очень желательно где-нибудь подробно описать алгоритм использования информации об оплате. наиболее интересные моменты - в течение которого времени разрешен выезд после получения данных об оплате. надо явно указать приоритет номера карты и то, что ГРЗ указывается справочно и при анализе данных не используется. что при любом проезде текущая информация по оплате данной карты становится недействительной. | ||
+ | - вышеупомянутый документ должен содержать правила обработки разрешений на выезд (так правильнее говорить вместо слова "платежей") из всех имеющихся в настоящее время источников с учетом их возможной специфики. | ||
+ | - при описании запроса истории проездов упомянут массив, то есть следует понимать, что это должна быть выходная информация, а вот входные параметры не описаны. |