4B Smart Offer Request optional

This API endpoint makes an HTTP GET request to retrieve offers related to a specific air purchase identified by the unique ID (buy_uid) and the smart_ff parameter. The response is in JSON format and includes various fields.

Request

The request does not require any specific input parameters. It retrieves smart frequent flyer offers based on the provided buy ID.

Response Fields:

status (string): Represents the status of the response.

message (string): Provides a message related to the response.

offers (array): Contains a list of offers.

buy_id (string): Represents the unique ID associated with the offer. You can take it from /api/air/offers

price (number): Indicates the price of the offer.

currency (string): Specifies the currency in which the price is denoted.

price_details (array): Contains details related to the price.

qty (number): Represents the quantity.

base (string): Indicates the base value.

base_amount (number): Represents the amount related to the base value.

tax (string): Specifies the tax information.

tax_amount (number): Represents the amount of tax.

tax_dtl (array): Contains detailed tax information.

code (string): Represents the code associated with the tax.

amount (number): Indicates the amount of tax.

currency (string): Specifies the currency for the tax amount.

fee (string): Specifies the fee information.

fee_amount (number): Represents the amount related to the fee.

single (string): Indicates a single value.

single_amount (number): Represents the amount related to the single value.

total (string): Specifies the total value.

total_amount (number): Represents the total amount.

base_total (number): Indicates the base total value.

fee_total (number): Represents the total fee amount.

tax_total (number): Represents the total tax amount.

passenger_type (string): Specifies the type of passenger.

type (string): Indicates the type of the offer.

base_total (number): Represents the base total value.

tax_total (number): Represents the total tax amount.

fee (number): Specifies the fee information.

comm (number): Represents the commission.

legs (array): Contains details related to the legs of the journey.

fare_family (string): Represents the fare family.

segments (array): Contains details of the segments.

baggage (string): Specifies the baggage information.

fare_basis (string): Represents the fare basis.

booking_class (string): Indicates the booking class.

service_class (string): Specifies the service class.

service_class_label (string): Provides a label for the service class.

departure_airport (string): Indicates the departure airport.

arrival_airport (string): Specifies the arrival airport.

marketing_airline (string): Represents the marketing airline.

airline_logo (string): Provides the URL for the airline logo.

ff_code (string): Indicates the frequent flyer code.

ff_data (object): Contains data related to frequent flyer details.

Various fields with specific data types and constraints.

The fields 'buy_id' and 'price' are of type string and number respectively, with no specific constraints or validations mentioned in the provided information.

Response

The response will be in JSON format with a status code of 200. It includes an array of offers, each containing details such as buy ID, price, currency, price details, base total, tax total, fee, commission, and legs. The legs section provides information about fare family, segments, baggage, fare basis, booking class, service class, departure and arrival airports, marketing airline, airline logo, frequent flyer code, and additional service details.

An example response is as follows:

{
  "status": "{string}",
  "message": "{string}",
  "offers": [
    {
      "buy_id": "{string}",
      "price": {number},
      "currency": "{string}",
      "price_details": [
        {
          "qty": {number},
          "base": "{string}",
          "base_amount": {number},
          "tax": "{string}",
          "tax_amount": {number},
          "tax_dtl": [
            {
              "code": "{string}",
              "amount": {number},
              "currency": "{string}"
            }
          ],
          "fee": "{string}",
          "fee_amount": {number},
          "single": "{string}",
          "single_amount": {number},
          "total": "{string}",
          "total_amount": {number},
          "base_total": {number},
          "fee_total": {number},
          "tax_total": {number},
          "passenger_type": "{string}",
          "type": "{string}"
        }
      ],
      "base_total": {number},
      "tax_total": {number},
      "fee": {number},
      "comm": {number},
      "legs": [
        {
          "fare_family": "{string}",
          "segments": [
            {
              "baggage": "{string}",
              "fare_basis": "{string}",
              "booking_class": "{string}",
              "service_class": "{string}",
              "service_class_label": "{string}",
              "departure_airport": "{string}",
              "arrival_airport": "{string}",
              "marketing_airline": "{string}",
              "airline_logo": "{string}",
              "ff_code": "{string}",
              "ff_data": {
                "name_short": "{string}",
                "name_class": "{string}",
                "name": "{string}",
                "name_pop": "{string}",
                "is_hand_luggage": {boolean},
                "hand_luggage": "{string}",
                "hand_luggage_str": "{string}",
                "is_baggage": {boolean},
                "baggage": "{string}",
                "baggage_str": "{string}",
                "is_refund": {boolean},
                "refund": "{string}",
                "is_change": {boolean},
                "change": "{string}",
                "is_seat_choice": {boolean},
                "seat_choice": "{string}",
                "services": [
                  {
                    "name": "{string}",
                    "status": "{string}",
                    "status_name": "{string}",
                    "is_bag": {boolean},
                    "scode": "{string}"
                  }
                ]
              }
            }
          ],
          "ff_hash": "{string}"
        }
      ]
    }
  ]
}

curl --location -g --request GET 'https://stage-api.etm-system.ru/api/air/offers/{{buy_uid}}/smart_ff' \ --header 'Etm-Auth-Key: ' \ --header 'Cookie: etmsessid=8Pwz9vY4oXUDj7ojfR5u1VdXsMW6xOVYosNxo08d'

{ "status": "ok", "message": "", "offers": [ { "buy_id": "ff_ff_request_ee7ae7f3-ea92-486a-bed5-2864e2b324e8_4d57fb09-3211-4a0a-8327-46f9fc8f5874_0_4_0", "price": 436.92, "currency": "EUR", "price_details": [ { "qty": 1, "base": "370,00 EUR", "base_amount": 370, "tax": "66,92 EUR", "tax_amount": 66.92, "tax_dtl": [ { "code": "YQ", "amount": "20.00", "currency": "EUR" }, { "code": "YR", "amount": "13.00", "currency": "EUR" }, { "code": "DE", "amount": "9.87", "currency": "EUR" }, { "code": "OY", "amount": "15.53", "currency": "EUR" }, { "code": "RA", "amount": "8.52", "currency": "EUR" } ], "fee": "0,00 EUR", "fee_amount": 0, "single": "436,92 EUR", "single_amount": 436.92, "total": "436,92 EUR", "total_amount": 436.92, "base_total": 370, "fee_total": 0, "tax_total": 66.92, "passenger_type": "adult", "type": "Взрослый" } ], "base_total": 370, "tax_total": 66.92, "fee": 0, "comm": 0, "legs": [ { "fare_family": "BUFLEX", "segments": [ { "baggage": "2PC", "fare_basis": "Z1FFX2", "booking_class": "Z", "service_class": "B", "service_class_label": "Бизнес", "departure_airport": "BER", "arrival_airport": "WAW", "marketing_airline": "LO", "airline_logo": "/images/airline/LO.svg", "ff_code": "BUFLEX", "ff_data": { "name_short": "BUFLEX", "name_class": "", "name": "BUFLEX", "name_pop": "BUFLEX<br>", "is_hand_luggage": true, "hand_luggage": "Ноутбук или ручная кладь до 85LCM. Включено", "hand_luggage_str": "Ноутбук или ручная кладь до 85LCM", "is_baggage": true, "baggage": "2 места багажа до 32кг каждое. Включено", "baggage_str": "2 места багажа до 32кг каждое. Включено", "is_refund": true, "refund": "Возврат билета. Включено", "is_change": null, "change": "", "is_seat_choice": true, "seat_choice": "Предварительное бронирование места. Включено", "services": [ { "name": "2 ручные клади по 8кг", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "CBC" }, { "name": "DATE CHANGE", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "068" }, { "name": "Багаж до 23 кг 158 см", "status": "extra", "status_name": "Платно", "is_bag": false, "scode": "0GO" }, { "name": "2 места багажа до 32кг каждое", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "FBC" }, { "name": "Возврат билета", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "056" }, { "name": "Предварительное бронирование места", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "0B5" }, { "name": "Легкая закуска и напитки", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "0b3" }, { "name": "Начисление миль", "status": "included", "status_name": "Включено", "is_bag": false, "scode": "057" }, { "name": "Ноутбук или ручная кладь до 85LCM", "status": "included", "status_name": "Включено", "is_bag": true, "scode": "04J" } ] } } ], "ff_hash": "QlVGTEVY" } ] } ] }

4B Smart Offer Request optional

Request#

Response Fields:#

Response#

Request

Responses

Request

Response Fields:

Response