Listar viagens
GET/travels
Retorna uma página de viagens publicadas.
Por padrão, a lista mostra apenas viagens que ainda não começaram (a data de início é hoje
ou uma data futura, pelo dia no fuso de Brasília). Para incluir viagens passadas, envie
start_date_from com uma data anterior.
A lista vem ordenada pela data de início, da mais próxima para a mais distante. Use sort
para mudar a ordem.
Todos os filtros são opcionais e podem ser combinados. Se algum parâmetro for inválido, a API
responde 422 e não retorna nenhuma viagem.
Requisição
Respostas
- 200
- 304
- 401
- 422
- 429
- 500
Uma página de viagens. Se nenhuma viagem corresponder aos filtros, data.data é uma lista vazia.
Cabeçalhos da resposta
O limite de requisições por minuto que vale para a sua requisição: o do token (1.000) ou o da agência (3.000), o que tiver menos espaço sobrando.
Quantas requisições ainda restam na janela atual de um minuto, no limite informado em X-RateLimit-Limit.
Uma identificação do conteúdo da resposta. Envie-a em If-None-Match na próxima consulta: se nada mudou, a API responde 304, sem o conteúdo.
private, max-age=60: a resposta pode ser reutilizada por 60 segundos, mas não deve ser guardada em caches compartilhados (CDN, proxy).
O conteúdo não mudou desde a resposta a que o ETag enviado em If-None-Match se refere. A resposta não traz corpo: continue usando a cópia que você já tem.
Cabeçalhos da resposta
Uma identificação do conteúdo da resposta. Envie-a em If-None-Match na próxima consulta: se nada mudou, a API responde 304, sem o conteúdo.
private, max-age=60: a resposta pode ser reutilizada por 60 segundos, mas não deve ser guardada em caches compartilhados (CDN, proxy).
O token não foi enviado, é inválido ou foi revogado. Este é o único formato de erro que não segue o envelope padrão.
Algum parâmetro da requisição é inválido. O campo errors indica, para cada parâmetro, o que está errado.
Você passou do limite de requisições por minuto (do token ou da agência). Espere o número de segundos indicado em Retry-After e tente de novo; se o erro se repetir, aumente a pausa a cada tentativa. Este erro não usa o envelope padrão.
Cabeçalhos da resposta
Quantos segundos esperar antes de tentar novamente.
O momento em que a janela reabre, como um timestamp Unix (segundos desde 1970).
O limite de requisições por minuto que vale para a sua requisição: o do token (1.000) ou o da agência (3.000), o que tiver menos espaço sobrando.
Quantas requisições ainda restam na janela atual de um minuto, no limite informado em X-RateLimit-Limit.
Ocorreu um erro inesperado na Avoei. O problema é registrado; tente novamente em instantes.