Listar viagens | Datalbus

Lista as viagens que iniciaram no dia informado (dia em UTC), com os trechos por motorista (subtrips).

Envie apenas os parâmetros documentados.

Resposta 200 (paginada). Cada item de data:

Campo	Tipo	Nulo	Descrição
`id`	integer	não	Id da viagem no Datalbus. Use como `{id}` em `/trips/{id}/events` e `/trips/{id}/locations`.
`drive_id`	integer	sim	Id da viagem no equipamento de telemetria
`asset_id`	integer	sim	Identificador do veículo na telemetria
`engine_hours`	number	sim	Horas de motor na viagem
`date`	string `YYYY-MM-DD HH:MM:SS`	sim	Início da viagem (UTC)
`end_drive`	string `YYYY-MM-DD HH:MM:SS`	sim	Fim da viagem (UTC)
`mileage`	number	sim	Distância percorrida na viagem (km)
`drive_duration`	string	sim	Duração da viagem (`HH:MM:SS`)
`total_mileage`	number	sim	Odômetro (km)
`fuel_used`	number	sim	Combustível consumido na viagem (litros)
`start_latitude` / `start_longitude`	string	sim	Posição de início
`end_latitude` / `end_longitude`	string	sim	Posição de fim
`log_gps_processed`	boolean	sim	Uso interno
`total_engine_hours`	number	sim	Horímetro (horas de motor acumuladas)
`trip_start_soc`	string	sim	Veículos elétricos: estado de carga da bateria (%) no início
`trip_start_range`	string	sim	Veículos elétricos: autonomia no início
`end_start_soc`	string	sim	Veículos elétricos: estado de carga da bateria (%) no fim
`end_start_range`	string	sim	Veículos elétricos: autonomia no fim
`recharge_energy`	string	sim	Veículos elétricos: energia recarregada
`electric_energy_consumption`	string	sim	Veículos elétricos: energia consumida
`regeneration_energy`	string	sim	Veículos elétricos: energia regenerada
`created_at` / `updated_at`	string (ISO-8601 UTC)	sim	Datas do registro
`license_plate`	string	sim	Placa do veículo
`license_nmbr`	string	sim	Prefixo do veículo
`line_name`	string	sim	Linhas operadas na viagem, separadas por vírgula (empresas com integração de linhas)
`subtrips`	array	não	Trechos da viagem por motorista identificado (pode ser vazio)

Cada item de subtrips:

Campo	Tipo	Nulo	Descrição
`id`	integer	não	Id do trecho
`trip_id`	integer	não	`drive_id` da viagem
`asset_id`	integer	sim	Identificador do veículo na telemetria
`start_drive`	string `YYYY-MM-DD HH:MM:SS`	não	Início do trecho (UTC)
`end_drive`	string `YYYY-MM-DD HH:MM:SS`	sim	Fim do trecho (UTC)
`driver_name`	string	não	Nome do motorista
`group_desc`	string	sim	Grupo do motorista
`worker_id`	integer	não	Matrícula do motorista
`mileage`	number	sim	Distância do trecho (km)
`fuel_used`	number	sim	Combustível do trecho (litros)
`idle_duration`	integer	sim	Tempo parado com motor ligado (segundos)

Erros: 400 para date ausente ou inválido e para per_page acima de 1000. Paginação: resposta no envelope paginado padrão (veja a Introdução). Navegue incrementando page até current_page = last_page.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

datestringOptional

Obrigatório. Dia de início das viagens, em UTC, no formato YYYY-MM-DD.

per_pageintegerOptional

Itens por página (1 a 1000, padrão 10).

Response

tointeger

datalist of objects

frominteger

pathstringformat: "uri"

linkslist of objects

totalinteger

per_pageinteger

last_pageinteger

current_pageinteger

last_page_urlstringformat: "uri"

first_page_urlstringformat: "uri"

next_page_urlany or nullOptional

prev_page_urlany or nullOptional

Errors

400

Listar Viagens Viagens Request Bad Request Error

401

Listar Viagens Viagens Request Unauthorized Error