|
<< Оглавление >> Введение |
![]() ![]()
|
1.Все методы шлюза "Профтикет" (далее также - шлюз) реализованы в виде метода интерфейса SOAP. Каждый метод реализуется в виде функции стандартного формата:
function MethodName(strInp: string): string; stdcall; (Pascal синтаксис)
string __stdcall MethodName(string strInp); (C++ синтаксис)
2.Входной параметр метода strInp – строка в формате XML-формата, отличающемся для каждого метода набором параметров.
3.Каждая функция возвращает строку в XML-формате, специфическом для каждого метода. Возвращаемая строка содержит как код возврата и описание возможной ошибки, так и возвращаемые данные.
4.Если какой-либо из входных параметров тега InputRow(см. далее) не задается, то он может быть указан как пустая строка ("") или не указан вовсе.
5.Удаленный пользователь авторизуется по указанному во входящем запросе логину и паролю.
6.Порядок атрибутов тегов <InputRow> (входные параметры) и <Row> (выходные параметры) – произвольный. Атрибуты должны обрабатываться по имени. Регистр входных параметров имеет значение. На практике, порядок выходных параметров (атрибутов тегов) может незначительно отличаться от приведенного в данном руководстве.
7.Параметры, указанные в квадратных скобках (например [cod_show]) являются необязательными.
8.Если метод использует пагинацию, в ответе также присутствует тег <AllRecords>.
9.Во входящих параметрах всех методов можно передать IP адрес зрителя в теге <IP>:
<GateReq>
<ReqLogin>
<UserName>....</UserName>
<UserPass>xxxxx</UserPass>
</ReqLogin>
<IP>xxx.xxx.xxx.xxx</IP>
<ReqBody>...
10.Список выходных параметров методов может количественно меняться в большую сторону без предварительного уведомления пользователей. Приведенные в данном руководстве входные параметры могут быть изменены только после предварительного уведомления пользователей! Вся информация об изменениях размещается в разделе "История"
11. В нынешней версии шлюз является только связующим звеном между сайтом и БД билетной системы ПрофТикет®. Методы шлюза позволяют получить информацию о местах проведения мероприятий, репертуаре, наличии свободных мест и т.п. Кроме того, шлюз позволяет забронировать и отметить факт продажи и возврата билетов. Обработка, внешний вывод данных, а также подключение к платежной системе, целиком относится к подключаемому сайту.
12. Пример строки подключения к шлюзу: http://187.198.34.12/scripts/ProfTicketGate.exe/wsdl/IProfTicket.
187.198.34.12 - адрес шлюза.
/scripts/ папка, где находится исполняемый модуль.
ProfTicketGate.exe сам исполняемый модуль.
/wsdl/IProfTicket - ссылка на соответствующий WSDL.
13. В некоторых случаях вместо wsdl нужно использовать soap (http://187.198.34.12/scripts/ProfTicketGate.exe/soap/IProfTicket). Это зависит от языка разработки сайта или программы, которые подключаются к шлюзу.