ITERIOS Travel API

GET tour/offers/:id

74 views 02.03.2019 0

Получение ценового предложения. Возвращает детальную информацию по ценовому предложению.
//todo actualize


GET tour/offers/:id
где :id — идентификатор ценового контейнера, который был получен при использовании метода POST tour/offers

Пример:

curl -i -H 'itapi-auth-token: some_key_value' https://itapi.iterios.com/api/v1/tour/offers/13

Параметры ответа (содержатся в ответе по ключу data):

Ключ Формат Описание
base_ci string claim_id для базового предложения
base_expire int, в минутах время актуальности базового предложения
base_adapter_id int id адаптера из справочников
offer_base object объект с информацией по ценовому предложению

Ключи для массива offer_base:

Ключ Формат Описание
status_info string с одним из значений process|completed|empty|error статус выгрузки массива tour_info
status_detail string с одним из значений process|completed|empty|error статус выгрузки массива tour_detail
tour_info object описан в tour/get-result, таблица 3.3
tour_detail object объект с детальной информацией, описан ниже
count_updates int количество обновлений
active bool активно ли ценовое предложение
last_update int, timestamp в секундах время последнего обновления

Массив offer_base_history состоит из элементов, в которых содержатся такие ключи:

Ключ Формат Описание
tour_info object описан в tour/get-result, таблица 3.3
tour_detail object объект с детальной информацией, описан ниже
last_update int, timestamp в секундах время последнего обновления

Массив offer_similar это объект, в котором ключи — id адаптера, а значения — объекты со следующими ключами:

Ключ Формат Описание
expire int, минуты время актуальности предложения
offers object ключи — claim_id, полученные от ТО, а значения — объекты, состоящие из ключей: status, tour_info, active
offers.status string с одним из значений process|completed|empty|error статус выгрузки tour_info
offers.tour_info object описан в tour/get-result, таблица 3.3
offers.active bool актуально ли ценовое предложение
offers.count_updates int количество обновлений
offers.last_update int — timestamp в секундах время последнего обновления

Массив tour_detail состоит из таких атрибутов:

Ключ Формат Описание
transport array массив, состоящий из объектов, в которых содержится информация по перелёту; описан ниже
service array массив, состоящий из объектов, в которых содержится информация по услугам

Каждый объект, входящий в массив transport, со следующими ключами:

Ключ Формат Описание
aircraft string название судна
flight_number string номер рейса
duration string hh:ii продолжительность рейса
airline object объект с информацией об авиакомпании
departure object объект с информацией об отправлении
arrival object массив с информацией о прибытии

Атрибуты ответа для массива service:

Ключ Формат Описание
type string, одно из значений hotel|plain|bus|train|visa|insurance|transfer|other тип услуги
description string текстовое описание услуги
period string период: диапазон дат, или текстовое описание длительности

Пример ответа:

{
   "data": {
      "base_offer": {
         "tour_info": {
            "status": "success",
            "status_key": null,
            "data": {
               "claim_id": "0x08000000006BC903300000000600000006A95500000000013A00000000000000080000574F0000000600000004000000040000000000000000000000000000000100000000A95D00000000000800000000006DDD000000000200000002000000020000000000000000636363A9550000A95D00000000000200",
               "dep_date": "2018-09-08",
               "ret_date": "2018-09-16",
               "nights": 8,
               "tickets": {
                  "econom": null,
                  "business": null
               },
               "price": 20887,
               "options": {
                  "transport_inc": null,
                  "ticket": null,
                  "room": null
               },
               "info": {
                  "tour_id": 314,
                  "tour_name": "ТУРЦИЯ:СТАМБУЛ_Киев авиа GDS",
                  "spo_id": 0,
                  "spo_name": ""
               },
               "moment_confirm": false,
               "exclusive": null,
               "promo": null,
               "promo_text": null,
               "recommended": false,
               "best_price": false,
               "early_booking": false,
               "dep_time": [
                  "T19:30+03:00"
               ],
               "dep_city": {
                  "id": 44135,
                  "name": "Kiev"
               },
               "currency": "UAH",
               "hotels": [
                  {
                     "id": 88986,
                     "name": "Malkoc Hotel",
                     "check_in": "2018-09-08",
                     "check_out": "2018-09-16",
                     "nights": 8,
                     "availability": "R",
                     "adult": 2,
                     "child": 0,
                     "hotel_url": "http://alf-ua.com/country/turtsiya/stambul/malkoc-hotel/",
                     "note": false,
                     "category": {
                        "id": null,
                        "name": null
                     },
                     "room": {
                        "orig_id": 6,
                        "orig_name": "STD"
                     },
                     "meal": {
                        "id": 2,
                        "name": "BB"
                     },
                     "accommodation": {
                        "orig_id": 4,
                        "orig_name": "DBL"
                     },
                     "city": {
                        "id": null,
                        "name": null
                     },
                     "country": {
                        "id": 226,
                        "name": "Turkey"
                     }
                  }
               ],
               "system_info": {
                  "tourinc": 314,
                  "stateinc": 6,
                  "programinc": 1,
                  "hotelinc": 22351,
                  "roominc": 6,
                  "htplaceinc": 4,
                  "mealinc": 10002,
                  "hnights": 8,
                  "adult": 2,
                  "child": 0,
                  "packet": 0,
                  "currency": 1,
                  "statspog": 0,
                  "dep_city_orig_id": "6"
               },
               "adapter_id": 24,
               "booking_url": "http://online.joinup.ua/bron?CLAIM=0x08000000006BC903300000000600000006A95500000000013A00000000000000080000574F0000000600000004000000040000000000000000000000000000000100000000A95D00000000000800000000006DDD000000000200000002000000020000000000000000636363A9550000A95D00000000000200&CURRENCY=2",
               "offer_key": "02170871877d0adb19e3440f8f94a0a4e8d14012",
               "expired_timestamp": 1536414992
            }
         },
         "offer_info": {
            "status": "success",
            "status_key": "tdetail.186.alfua",
            "data": "{\"transport\":null,\"service\":[{\"type\":\"plain\",\"description\":\"\ \К\и\е\в -> \С\т\а\м\б\у\л, ECONOM\",\"period\":\"08.09.2018 - 08.09.2018\"},{\"type\":\"hotel\",\"description\":\"\ MALKOC HOTEL BUTIK, STD\\/DBL, BB\",\"period\":\"08.09.2018 - 16.09.2018\"},{\"type\":\"insurance\",\"description\":\"\ \Т\у\р\ц\и\я: 30 000+1000 Turky\",\"period\":\"08.09.2018 - 16.09.2018\"},{\"type\":\"plain\",\"description\":\"\ \С\т\а\м\б\у\л -> \К\и\е\в, ECONOM\",\"period\":\"16.09.2018 - 16.09.2018\"}]}"
         },
         "is_active": true,
         "expired_at": null,
         "count_updates": null
      },
      "similar_offers": []
   }
}

Was this helpful?