Pular para o conteúdo principal

Guia de Migração: WCF (AereoNoSession.svc) ➔ Web API Aéreo

:::caution ATENÇÃO DESENVOLVEDORES O serviço WCF AereoNoSession.svc está oficialmente em fase de legado e descontinuação. Todas as novas integrações e atualizações de clientes existentes devem adotar a Web API Aéreo (V2). :::

Este guia detalha o processo de migração para desenvolvedores que atualmente consom o WCF Travellink em JSON e precisam transicionar suas integrações para a Web API REST.

1. Por que não é possível apenas trocar a URL?​

Uma virada direta sem ajustes falhará pelos seguintes motivos:

  1. Alteração de Rotas: No WCF, as chamadas eram para POST .../AereoNoSession.svc/{Operacao}. Na Web API, as rotas utilizam o prefixo REST POST .../api/V2/Voos/{Operacao}.
  2. Formato de Datas: O WCF utiliza o formato proprietário da Microsoft: "/Date(1784257200000-0300)/". A Web API serializa no padrão moderno ISO 8601: "2026-10-15T00:00:00".
  3. Fim da Pré-autenticação Obrigatória: No WCF, alguns clientes chamavam o método Autenticar. Na Web API V2, a autenticação é 100% stateless (as credenciais de login/senha e tokens vão em cada requisição).
  4. V1 vs V2: A rota antiga da Web API V1 (/api/Voos) envelopava as respostas no modelo { "Disponibilidade": {...}, "Sucesso": true }. A V2 (/api/V2/Voos) removeu esse envelope e devolve o DTO direto na raiz, alinhado à simplicidade de consumo!

2. Matriz de Equivalência de Endpoints​

Abaixo está o mapa completo de como migrar cada chamada do WCF para a Web API Aéreo:

Operação WCF (AereoNoSession.svc)Equivalente na Web API (V2)Situação
Autenticar(Não necessário)Envie Login/Senha no body de cada request.
RecuperarSistemasPesquisaPOST /api/V2/Voos/RecuperarSistemasPesquisa100% compatível
RecuperarSistemasPOST /api/V2/Voos/RecuperarSistemas100% compatível
DisponibilidadePOST /api/V2/Voos/Disponibilidade100% compatível
DisponibilidadeMultiplaPOST /api/V2/Voos/DisponibilidadeMultipla100% compatível
TarifarPOST /api/V2/Voos/Tarifar100% compatível
ObterRegraDaTarifaPOST /api/V2/Voos/ObterRegraDaTarifa100% compatível
ReservarPOST /api/V2/Voos/Reservar100% compatível
ConsultarPOST /api/V2/Voos/Consultar100% compatível
CancelarPOST /api/V2/Voos/Cancelar100% compatível
IniciarEmissaoPOST /api/V2/Voos/IniciarEmissao100% compatível
RecuperarFormasDeFinanciamentoPOST /api/V2/Voos/RecuperarFormasDeFinanciamento100% compatível
EmitirPOST /api/V2/Voos/Emitir100% compatível
ConsultarEticketPOST /api/V2/Voos/ConsultarEticket100% compatível
CancelarEticketPOST /api/V2/Voos/CancelarEticket100% compatível
ListarReservasPOST /api/V2/Voos/ListarReservas100% compatível
ListarEticketsPOST /api/V2/Voos/ListarEtickets100% compatível
BuscarReservaPOST /api/V2/Voos/BuscarReserva100% compatível
BuscarEticketsPOST /api/V2/Voos/BuscarEtickets100% compatível
BuscarPOST /api/V2/Voos/Buscar100% compatível
ObterMapaDeAssentosPOST /api/V2/Voos/ObterMapaDeAssentos100% compatível
MarcarAssentosPOST /api/V2/Voos/MarcarAssentos100% compatível
RemoverAssentosPOST /api/V2/Voos/RemoverAssentos100% compatível
DisponibilidadeDeServicoAuxiliarPOST /api/V2/Voos/DisponibilidadeDeServicoAuxiliar100% compatível
TarifarServicoAuxiliarPOST /api/V2/Voos/TarifarServicoAuxiliar100% compatível
GravarServicoAuxiliarPOST /api/V2/Voos/GravarServicoAuxiliar100% compatível
CancelarServicoAuxiliarPOST /api/V2/Voos/CancelarServicoAuxiliar100% compatível
DetalhesdeFamiliaPOST /api/V2/Voos/DetalhesdeFamilia100% compatível
AlterarReservaTarifarPOST /api/V2/Voos/AlterarReservaTarifar100% compatível
AlterarReservaConfirmarPOST /api/V2/Voos/AlterarReservaConfirmar100% compatível
GravarReservaPOST /api/V2/Voos/GravarReserva100% compatível
GravarVendaPOST /api/V2/Voos/GravarVenda100% compatível
EnviarPlanoDeViagemPOST /api/V2/Voos/EnviarPlanoDeViagem100% compatível
BuscarFilaPOST /api/V2/Voos/BuscarFila100% compatível
BuscarNotificacaoPOST /api/V2/Voos/BuscarNotificacao100% compatível
ListarNotificacoesPOST /api/V2/Voos/ListarNotificacoes100% compatível
ExcluirNotificacaoPOST /api/V2/Voos/ExcluirNotificacao100% compatível

3. Passo a Passo da Migração​

Passo 1: Atualizar Headers​

Os headers de autenticação técnica permanecem os mesmos:

  • developer-token: Seu token de desenvolvedor Wooba.
  • developer-access-code: Criptografia RSA PKCS1 em Base64 da chave com timestamp.
  • Content-Type: application/json

Passo 2: Atualizar os Endpoints de Chamada​

Substitua:

POST https://wooba-api.travellink.com.br/wcftravellinkjson/AereoNoSession.svc/Disponibilidade

Por:

POST https://wooba-api.travellink.com.br/api/V2/Voos/Disponibilidade

Passo 3: Atualizar o Formato de Datas nos Requests​

Embora a Web API aceite datas em formato Microsoft no input, é altamente recomendado enviar no padrão ISO 8601:

  • De: "DataIda": "/Date(1784257200000-0300)/"
  • Para: "DataIda": "2026-10-15T00:00:00" (ou "2026-10-15")

Passo 4: Atualizar Desserializadores de Resposta para ISO 8601​

Certifique-se de que sua biblioteca HTTP (HttpClient no C#, Axios no Node, Requests no Python, etc.) está configurada para interpretar datas ISO 8601 nativamente ao desserializar as propriedades DataIda, DataVolta, Data, etc.