Pular para o conteúdo principal

Formatos e Tratamento de Datas

Ao integrar com a Web API Aéreo, é fundamental compreender a gestão de datas entre clientes novos e clientes legados.

1. Padrão Nativo: ISO 8601​

A Web API Aéreo utiliza por padrão o formato universal ISO 8601:

{
  "DataIda": "2026-10-15T00:00:00",
  "DataVolta": "2026-10-22T00:00:00"
}

Formatos aceitos nas requisições:

  • YYYY-MM-DDTHH:mm:ss (ex: 2026-10-15T14:30:00)
  • YYYY-MM-DD (ex: 2026-10-15)

2. Compatibilidade com o Formato Legado WCF​

No serviço legado WCF, datas eram representadas no formato Microsoft:

{
  "DataIda": "/Date(1784257200000-0300)/"
}

Na Entrada (Requests)​

O mecanismo de deserialização da Web API aceita nativamente ambas as formas. Clientes podem enviar tanto /Date(...)/ quanto ISO 8601 sem gerar erros de serialização.

Na Saída (Responses)​

Por padrão, a Web API devolve respostas em ISO 8601. Para clientes legados que dependem de \/Date(...)\/, a API pode ser estendida via header de compatibilidade (X-Date-Format: Microsoft) ou via configuração no formatador JSON para emitir DateFormatHandling.MicrosoftDateFormat.