A API de Voos permite que desenvolvedores e aplicativos acessem informações sobre voos, incluindo horários, itinerários, aeroportos e companhias aéreas.
A API de Comparação de Tarifas de Voos permite que desenvolvedores e aplicativos acessem e comparem as tarifas de voos oferecidas por diferentes Agências de Viagens Online (OTAs). Essa API facilita a busca pela melhor oferta de voos, fornecendo informações detalhadas sobre preços e disponibilidade
Atenção: essa pesquisa pode ser combinada com a Pesquisa Básica.
Autenticação
Para utilizar a API de Comparação de Tarifas de Voos, é necessário obter uma chave de API (API key). Essa chave deve ser incluída no cabeçalho de cada solicitação feita à API, como mostrado no exemplo abaixo:
Siga os passos da documentação para obter o token de acesso: https://moblix.readme.io/reference/apitoken
Requisição
Se você deseja utilizar o Comparador de Tarifas, preencha o ida da CIA como "1300"
Exemplo de requisição:
{
"Origem": "CGH",
"Destino": "SSA",
"Ida": "2023-07-15",
"Volta": "2023-07-20",
"Adultos": 1,
"Criancas": 0,
"Bebes": 0,
"Companhia": 1300,
}
Importante: Dessa forma, a API retornará pesquisará os voos em todas as OTAs disponíveis.
Recursos disponíveis
Listar voos
Endpoint: POST /ConsultaAereo/Consultar
****Parâmetros disponíveis:
- origem: (opcional) código do aeroporto de origem
- destino: (opcional) código do aeroporto de destino
- ida: data de partida no formato "YYYY-MM-DD"
- volta: (opcional) data de partida no formato "YYYY-MM-DD"
- Adultos:
- Crianças
- Bebes
- Companhia: "1300" para receber todas as OTAs.
Exemplo de resposta:
{
"TotalItens": 1,
"Completed": true,
"Success": true,
"HasResult": true,
"Erro": null,
"MensagemErro": null,
"Data": [
{
"TokenConsulta": null,
"QntdAdulto": 1,
"QntdCrianca": 0,
"QntdBebe": 0,
"Ida": [
{
"Token": null,
"IdCia": 2,
"CiaParceira": null,
"Cia": {
"Id": 2,
"Nome": "Gol",
"Iata": "G3",
"AtivaBusca": true,
"Icao": "CIX",
"Pais": "Burundi",
"DadosCia": [],
"ConfiguracaoBagagem": [],
"CupomDescontoRestricao": [],
"TaxaEmbarque": [],
"Configuracao": [],
"LogResultado": [],
"LogConsulta": [],
"CacheConsulta": [],
"ConfigProxy": [],
"ProgramaFidelidadeTipo": [],
"ApiRequests": [],
"FranqueadoPolitica": [],
"Ids": null,
"_PageNumber": 0,
"PageNumber": 0,
"PageSize": 0,
"OrderBy": null,
"OrderDesc": false
},
"PontosAdulto": 0.0,
"PontosCrianca": 0.0,
"QntdBagagem": 0,
"QtdBagagemInclusa": 0,
"Taxas": {
"IdCia": 0,
"Servico": 0.0,
"ServicoChd": 0.0,
"Embarque": -1.0,
"EmbarqueChd": 0.0,
"EmbarqueStr": null,
"EmissaoResgate": 0.0,
"ValorFranquia": 0.0,
"Bagagens": null
},
"Voos": [
{
"Numero": "1628",
"Saida": "2023-07-15T22:55:00",
"Chegada": "2023-07-16T01:15:00",
"Origem": "GRU",
"Destino": "SSA",
"Duracao": 0,
"Tempo": "140",
"TempoEspera": "0",
"Classe": 0,
"ClasseStr": "economy"
}
],
"Tarifas": null,
"ValorAdulto": -1.0,
"ValorAdultoStr": null,
"ValorAdultoNaCia": 0.0,
"ValorCrianca": 0.0,
"ValorBebe": 0.0,
"ValorTotal": 0.0,
"ValorTotalComTaxa": 1061.12,
"ValorTotalTaxas": 0.0,
"FareOriginType": null,
"Origem": "GRU",
"Destino": "SSA",
"Saida": "2023-07-15T22:55:00",
"Chegada": "2023-07-16T01:15:00",
"Duracao": 0,
"TempoTotalStr": "02h 20m",
"ValorTxServico": 0.0,
"PercentualEconomia": 0.0,
"FlightCode": "1628",
"Periodo": 3,
"Adultos": 0,
"Criancas": 0,
"BagagensInclusas": null,
"Site": "123milhas.com",
"Nome": "123 Milhas",
"UrlPesquisa": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.y3ryfhZ_Y6fjlTWS4X8A6w.21132.4265ba5768c3ebf41d2b1ba99fdea88b&h=cd8f4782db2d&sub=E-179bac3139b&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Outros": [
{
"Nome": "MaxMilhas",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.c4xJKgzon-dgnmZp3rSjRQ.22976.4265ba5768c3ebf41d2b1ba99fdea88b&h=67bf5f4a40c0&sub=E-1402cb3fc87&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1153.72,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "maxmilhas.com.br"
},
{
"Nome": "GOL",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.gkymE97lAzU.27101.4265ba5768c3ebf41d2b1ba99fdea88b&h=9b88535fd327&sub=E-1d15f35b25f&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1360.89,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "voegol.com.br"
},
{
"Nome": "Booking.com",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.HceeID8kIYIMlOqRgOKZ7A.28882.4265ba5768c3ebf41d2b1ba99fdea88b&h=c6ff21bffb08&sub=E-1aef63d5a27&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1450.33,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "flights.booking.com"
},
{
"Nome": "Zupper",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.nvCtXeNjH_gEdn9PX-8xhQ.29157.4265ba5768c3ebf41d2b1ba99fdea88b&h=3561a208faa2&sub=E-1be6b2300f1&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1464.15,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "zupper.com.br"
},
{
"Nome": "FlightNetwork",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.lPAzY077B9kUPBPf-jqMFw.29325.4265ba5768c3ebf41d2b1ba99fdea88b&h=c802952d664a&sub=E-1d9733ac6d6&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1472.56,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "FlightNetwork.com"
},
{
"Nome": "Expedia",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.ZpbE3-UY8hoNUvH8T-y68A.29672.4265ba5768c3ebf41d2b1ba99fdea88b&h=47a647572161&sub=E-1aa3f70137b&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1489.97,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "Expedia.com.br"
},
{
"Nome": "Chalinga",
"Url": "https://www.kayak.com.br/in?cluster=4&a=litemilhasapi&url=/book/flight?code=cbAiIwR7D6.bwxXQ4Jhh2IDzQq2dWkU9A.31245.4265ba5768c3ebf41d2b1ba99fdea88b&h=414562ad0aef&sub=E-13c56597006&_sid_=R-4gKNjBRbII6ReKcgp9AcV-v3pjWjA1X1z9kpdGBtcVQUEssK1dCeP5E_Ws_GExw",
"Valor": 1569.0,
"Cabine": "economy",
"OpcaoReserva": "Economy",
"Site": "chalinga.com.br"
}
],
"Classe": 0
},
Informação: Voos com Pontuação Negativa
Voos que apresentam pontuação negativa indicam que são voos pagantes, ou seja, não utilizam milhas para a compra das passagens. Caso prefira que sua pesquisa retorne apenas voos que utilizem milhas, siga os passos abaixo:
- Acesse o painel de controle Moblix em: https://painel.moblix.com.br/#/ValoresCias
- Localize a companhia aérea desejada na lista.
- Desmarque a opção "Pagante" correspondente à companhia aérea selecionada.
Ao realizar essas alterações, sua pesquisa exibirá apenas voos que podem ser adquiridos com milhas, proporcionando maior conveniência para os usuários que desejam utilizar seus pontos acumulados em programas de fidelidade.
"PontosAdulto": -1.0
Agora que você entende como os dados retornados pela API de Voos da Moblix são estruturados, fica mais fácil personalizar a exibição das informações para seus usuários e proporcionar uma experiência de pesquisa de passagens aéreas mais agradável e eficiente.