|
|
Для получения доступа к api в целях получения информации по экскурсионным турам необходимо: 1. В TS:Operator сгенерировать вебхук для получения доступа к api модуля. Для этого нужно пройти по пути TS:Operator->Справочники->Вебхуки -> Добавить вебхук:  Далее вписать название компании и нажать сохранить. После этих действий сгенерируется url доступа к api модуля. 2. Получившийся url необходимо передать компании, для которой он был сгенерирован. url не должен передаваться третьим лицам. Для выполнения запросов к api модуля необходимо перейти по сгенерированному url предварительно заменив метку method_name на название метода.  Для передачи параметров следует передавать в url get параметры. Например https://site.com/rest/875/f0qxfdhznwqn5ud9/getbyid/?id=39 - в данном случае мы получим описание тура в системе с id = 39. По умолчанию все ответы приходят в json формате. Для получения результата в xml формате необходимо в url запроса вместо метки method_name указать "название метода".xml. Например: https://#server_name#/rest/877/9l2q6h1eix840g23/tourprices.xml/?id=394&date_from=20.12.2019&date_to=10.01.2020&adults=2&children=0. При успешном результате выполнения ответ будет содержать ключ result в котором и будет находиться массив с результатом. При не успешном ответ содержит код ошибки в ключе error и описание ошибки в ключе error_description. На данный момент доступно три метода: getlist - получает список туров с описанием. Доступные параметры для передачи: count - количество получаемых элементов за запрос (не более 50) (параметр необязательный. по-умолчанию 50) page - номер страницы для получения списка туров. (параметр необязательный. по-умолчанию 1) В ответе возвращается массив масcивов полей с описанием Ключ в ответе result имеет вид [items: [], total_count: 123] - где items - это туры с описанием, а total_count - общее число туров tsoperator. Если ключ result - пустой массив - это значит нет доступного описания по туру Пример: https://site.com/rest/875/f0qxfdhznwqn5ud9/getlist/?count=20&page=2 getbyid - получает описание конкретного тура по id. Доступные параметры для передачи: id - id тура в системе (параметр обязательный) В ответе возвращается массив полей с описанием Если ключ result - пустой массив - это значит нет доступного описания по туру Пример: https://site.com/rest/875/f0qxfdhznwqn5ud9/getbyid/?id=39 tourPrices - получает предложения с ценами по туру для дат. Доступные параметры для передачи: id - ID тура в системе (обязательный) date_from - дата с которой искать предложение в формате dd.mm.yyyy (параметр обязательный) date_to - дата до которой искать предложение в формате dd.mm.yyyy (параметр обязательный) adults - кол-во взрослых (параметр необязательный. по-умолчанию 1) children - (параметр необязательный. по-умолчанию 0) children_age - [массив значений возрастов для детей. Количество возрастов должно быть равно числу указанному в параметре children. По умолчанию возраст принимается равным 6 для каждого ребенка для которого не указан возраст] (необязательный) В ответе возвращается массив массивов полей с рассчитанными и доступными ценовыми предложениями по туру для данного запроса. Если ключ result - пустой массив - это значит нет доступных предложений по туру для данного запроса Пример: https://site.com/rest/813/i7u5xzjzx2h8ris8/tourprices/?id=39&date_from=30.12.2019&am.... При успешном результате выполнения ответ будет содержать ключ result в котором и будет находиться массив с результатом. Добавление / редактирование агента | Описание курса | Документов |