Различия

Здесь показаны различия между двумя версиями данной страницы.

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

Artonit

Инструменты пользователя

Инструменты сайта

Различия

Инструменты страницы