Ajuda

Importar voos: JSON

Antes de importar

Os voos importados são adicionados ao seu diário de bordo em qualquer plano, incluindo o plano gratuito Frequent Flyer. A subscrição Crew desbloqueia as funcionalidades avançadas que se apoiam no seu histórico de voos.

Visão geral

A importação de voos traz todo o seu histórico de viagens para o MyFlight.Life num único passo.

Importar voos com JSON

Os voos podem ser carregados num formato JSON suportado que descreve os aeroportos, as datas e os segmentos de cada viagem.

Carregamento em massa

É possível importar até 1000 voos ou 10 ficheiros durante toda a vida de uma conta — ideal para transferir de uma só vez um histórico de viagens extenso.

Estrutura do ficheiro

Flight information

Flight information
FieldTypeRequiredDescription
airportsArrayRequired
The airports of the trip, each with its IATA code and whether it was visited.
Example: { "iata": "DUB", "visited": true }
with_returnBooleanRequired
Whether the flight includes a return trip.
departure_onStringRequired
ISO 8601 timestamp of the departure date and time.
Example: 2025-02-15T08:35:00.000Z
Note: Do not include a timezone designator — treat dates as generic and timezone-agnostic.
return_onStringRequired
ISO 8601 timestamp of the return date and time.
Example: 2025-02-18T21:35:00.000Z
Note: For a one-way flight, set this to the same value as departure_on.
Note: Do not include a timezone designator — treat dates as generic and timezone-agnostic.

Flight details

Flight details
FieldTypeRequiredDescription
flight_typeIntegerRequired
Type of flight — see Flight types in Import codes below.
legsArrayRequired
The individual flight segments. Pass an empty array [] when leg data isn't available.

Flight legs

Cada entrada do array legs descreve um único segmento de voo.

Flight legs
FieldTypeRequiredDescription
orderIntegerRequired
Position of this segment within the trip.
Example: 0, 1, 2…
airline_mfl_idStringRequired
IATA identifier of the airline. Pass null when unknown.
airplane_mfl_idStringRequired
IATA identifier of the aircraft model. Pass null when unknown.
flight_numberStringRequired
Flight number for this segment. Pass null when unknown.
airplane_numberStringRequired
Aircraft registration number. Pass null when unknown.
seatStringRequired
Seat for this segment. Pass null when unknown.
seat_typeIntegerRequired
Type of seat — see Flight seat types in Import codes below.
flight_class_typeIntegerRequired
Class of this segment — see Flight classes in Import codes below.

Códigos de importação

Os campos numéricos acima correspondem a estes códigos.

Flight types

Flight types
CodeNameDescription
10LeisureHolidays, personal travel or recreation.
20BusinessProfessional or work-related travel.
30CrewLogged as airline or aviation crew duty.
40PrivateA flight on a private aircraft.

Flight classes

Flight classes
CodeNameDescription
10EconomyStandard class with basic seating and amenities.
20Premium EconomyMore space and service than Economy.
30Business ClassPremium seating with enhanced service.
40First ClassThe highest class, with top-tier service.
50PrivateA flight on a private aircraft, with no shared cabin.
60CrewA flight taken as a crew member.
90OtherAny class outside the standard categories.

Flight seat types

Flight seat types
CodeNameDescription
10WindowA seat next to the aircraft window.
20MiddleA seat between the window and aisle.
30AisleA seat next to the aisle.
40PrivateExclusive seating on a private aircraft.
50CrewA seat designated for crew.
90OtherAny seat type outside the standard categories.

Ficheiro de exemplo

[
  {
    "flight": {
      "airports": [
        { "iata": "DUB", "visited": true },
        { "iata": "JFK", "visited": true }
      ],
      "with_return": false,
      "departure_on": "2025-01-15T08:35:00.000Z",
      "return_on": "2025-01-15T08:35:00.000Z"
    },
    "details": {
      "flight_type": 10,
      "legs": []
    }
  },
  {
    "flight": {
      "airports": [
        { "iata": "DUB", "visited": true },
        { "iata": "AMS", "visited": true },
        { "iata": "KBP", "visited": true }
      ],
      "with_return": true,
      "departure_on": "2025-02-15T08:35:00.000Z",
      "return_on": "2025-02-18T21:35:00.000Z"
    },
    "details": {
      "flight_type": 20,
      "legs": [
        {
          "order": 0,
          "airline_mfl_id": "KL",
          "airplane_mfl_id": "738",
          "flight_number": "KL936",
          "airplane_number": "PH-BXA",
          "seat": "12A",
          "seat_type": 10,
          "flight_class_type": 30
        },
        {
          "order": 1,
          "airline_mfl_id": "KL",
          "airplane_mfl_id": "738",
          "flight_number": "KL3099",
          "airplane_number": "PH-BXA",
          "seat": "12A",
          "seat_type": 10,
          "flight_class_type": 30
        }
      ]
    }
  }
]