Master-Interlook:IntegrationService — различия между версиями

Материал из Megatec
Перейти к: навигация, поиск
[непроверенная версия][непроверенная версия]
(→‎Введение)
(→‎Методы IntegrationService)
Строка 12: Строка 12:
  
 
===Connect (получение аутентификационного токена)===
 
===Connect (получение аутентификационного токена)===
−
Метод производит получение аутентификационного токена, необходимого для выполнения метода '''CreateReservation'''
+
Метод производит получение аутентификационного токена, необходимого для выполнения метода '''CreateReservation'''.<br />
  
−
* Принимаемые параметры запроса ( '''*''' – обязательный):
+
Принимаемые параметры запроса ( '''*''' – обязательный):
−
** '''Login *''' – логин online пользователя
+
* '''Login *''' – логин online пользователя
−
** '''Password *''' – пароль online пользователя
+
* '''Password *''' – пароль online пользователя
−
* Возвращаемый результат:
+
Возвращаемый результат:
−
** '''ConnectResult''' – идентификатор аутентификации, если аутентификация прошла успешно, ''-1'' в противном случае
+
* '''ConnectResult''' – идентификатор аутентификации, если аутентификация прошла успешно, ''-1'' в противном случае
  
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
 
<div class="toccolours mw-collapsible mw-collapsed" style="width:900px">Пример
Строка 63: Строка 63:
  
 
===CreateReservation (бронирование путевки)===
 
===CreateReservation (бронирование путевки)===
−
Метод производит бронирование путевки.
+
 
−
* Формат запроса:
+
Метод производит бронирование путевки.<br />
−
** POST http:// [your server address] / [service folder] /IntegrationService.asmx
+
Принимаемые параметры запроса:
−
* Принимаемые параметры headers ( '''*''' – обязательный):
+
* '''Guid''' – идентификатор аутентификации (возвращается при запросе к методу [[Master-Interlook:Описание методов#Connect (получение аутентификационного токена)|Connect]])
−
** '''Content-Type *''' – text/xml; charset=utf-8
+
* '''HasInvoices''' – выставлен ли счет по путевке ('''true''' – выставлен, '''false''' – не выставлен)
−
* Принимаемые параметры POST запроса:
+
** '''true''' – счет выставлен
−
** '''Guid''' – идентификатор аутентификации (возвращается при запросе к методу [[Master-Interlook:Описание методов#Connect (получение аутентификационного токена)|Connect]])
+
** '''false''' – счет не выставлен
−
** '''HasInvoices''' – инвойсы по путевке (выставлен ли счет по путевке)
+
* '''Rate''' – валюта путевки:
−
***
+
** '''ID''' – идентификатор валюты
 +
** '''Name''' – название валюты
 +
** '''Code''' – код валюты
 +
** '''Unicode''' – код ISO для валюты
 +
** '''IsMain''' – является ли валюта главной ('''true''' – является, '''false''' – не является)
 +
** '''IsNational''' – является ли валюта национальной ('''true''' – является, '''false''' – не является)
 +
* '''ID''' – идентификатор путевки (если указано ''-1'' – создается новая путевка, если ID путевки из базы данных – перебронирование указанной)
 +
* '''Netto''' – нетто цена путевки
 +
* '''Brutto''' – брутто цена путевки
 +
* '''CountryID''' – идентификатор страны путевки

Версия 15:21, 8 июля 2021

Версия статьи от 8-07-2021.

Поддерживаемые версии «»:
Начиная с


Введение

API InterlookIntegrationService работает по SOAP протоколу. Для вызова методов API можно использовать SoapUi.

Методы IntegrationService

Connect (получение аутентификационного токена)

Метод производит получение аутентификационного токена, необходимого для выполнения метода CreateReservation.

Принимаемые параметры запроса ( * – обязательный):

  • Login * – логин online пользователя
  • Password * – пароль online пользователя

Возвращаемый результат:

  • ConnectResult – идентификатор аутентификации, если аутентификация прошла успешно, -1 в противном случае
Пример

Вызов метода Connect 

POST /IntegrationServiceCP/IntegrationService.asmx HTTP/1.1
Host: supp-08.megatec.ru
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.megatec.ru/Connect"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <Connect xmlns="http://www.megatec.ru/">
      <login>sm1</login>
      <password>123</password>
    </Connect>
  </soap:Body>
</soap:Envelope>

Возвращаемый результат метода Connect 

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConnectResponse xmlns="http://www.megatec.ru/">
      <ConnectResult>30b033a8-0d5b-4a2c-bcf0-2c671e4c6169</ConnectResult>
    </ConnectResponse>
  </soap:Body>
</soap:Envelope>


CreateReservation (бронирование путевки)

Метод производит бронирование путевки.
Принимаемые параметры запроса:

  • Guid – идентификатор аутентификации (возвращается при запросе к методу Connect)
  • HasInvoices – выставлен ли счет по путевке (true – выставлен, false – не выставлен)
    • true – счет выставлен
    • false – счет не выставлен
  • Rate – валюта путевки:
    • ID – идентификатор валюты
    • Name – название валюты
    • Code – код валюты
    • Unicode – код ISO для валюты
    • IsMain – является ли валюта главной (true – является, false – не является)
    • IsNational – является ли валюта национальной (true – является, false – не является)
  • ID – идентификатор путевки (если указано -1 – создается новая путевка, если ID путевки из базы данных – перебронирование указанной)
  • Netto – нетто цена путевки
  • Brutto – брутто цена путевки
  • CountryID – идентификатор страны путевки
Источник — «http://wiki.megatec.ru/index.php?title=Master-Interlook:IntegrationService&oldid=25997»