Passar para o conteúdo principal

Web API – Viagens

Documentação da Web API para Gerenciar Registros de Viagens

Listar Viagens

URL da requisição

Parâmetros de consulta

  • startDate – Formato ‘yyyy-mm-dd’, p. ex. ‘2015-01-31’ significa meia-noite de 31 de janeiro de 2015 no seu fuso horário local. Inclusivo.

  • endDate – Formato ‘yyyy-mm-dd’, p. ex. ‘2015-12-31’. Inclusivo.

  • userEmail – Endereço de e-mail de um usuário específico a pesquisar.

  • activity – Atividade da viagem, p. ex. ‘Business’.

  • minLastUpdated – A data em que o registro foi modificado ou criado. Formato ‘yyyy-mm-dd’. Inclusivo.

  • maxLastUpdated – A data em que o registro foi modificado ou criado. Formato ‘yyyy-mm-dd’. Inclusivo.

  • status – Status de aprovação. As opções válidas são: ‘U’ – não enviado, ‘S’ – enviado, ‘A’ – aprovado, ‘R’ – rejeitado, ‘P’ – pagamento agendado.

Observação

Você precisa fornecer pelo menos um dos parâmetros de consulta na requisição.
O DateTime retornado na resposta está no fuso horário UTC, conforme o padrão JSON.

Existe um limite interno de taxa para o intervalo de datas, que o limita a um ano. Ao obter uma lista de viagens, a diferença entre a Data de início e a Data de término deve ser menor ou igual a 1 ano. Se o período for muito grande, pode ocorrer um tempo limite esgotado ou uma falha no retorno.

Exemplo

Exemplo de Retorno

{
"id": 999999,
"url": "https://www.triplogmileage.com/web/api/trips/999999",
"lastUpdated": "2026-08-17T16:17:37.229Z",
"user": {
"id": 111111,
"url": "https://www.triplogmileage.com/web/api/users/111111",
"email": "user@triplog.net",
"display": "User, Demo"
},
"vehicle": {
"id": 222222,
"url": "https://www.triplogmileage.com/web/api/vehicles/222222",
"lastUpdated": "2026-01-07T17:35:42.907Z",
"display": "2026 Default Vehicle"
},
"startTime": "2026-03-22T21:04:00.000Z",
"endTime": "2026-03-22T21:31:00.000Z",
"startOdometer": 558,
"endOdometer": 566,
"mileage": 7.9,
"fromLocation": {
"id": 333333,
"url": "https://www.triplogmileage.com/web/api/locations/333333",
"lastUpdated": "2026-01-30T00:23:54.802Z",
"display": "1234 N Main St, AnytownUSA, NC 12345",
"name": HeadQuarters,
"address": "1234 N Main St, AnytownUSA, NC 12345",
"latitude": 13.123456,
"longitude": -12.123456
},
"toLocation": {
"id": 444444,
"url": "https://www.triplogmileage.com/web/api/locations/444444",
"lastUpdated": "2024-09-20T01:41:34.473Z",
"display": "4321 Front St, AnytownUSA, NC 12345",
"name": Client Location,
"address": "4321 Front St, AnytownUSA, NC 12345",
"latitude": 13.654321,
"longitude": -12.654321
},
"activity": "Business",
"parking": 0.0,
"toll": 0.0,
"tags": null,
"notes": null,
"status": "A",
"statusUpdateTime": "2026-08-17T16:17:37.000Z",
"statusUpdatedBy": {
"id": 987654,
"url": "https://www.triplogmileage.com/web/api/users/987654",
"email": "admin@triplog.net",
"display": "Admin, TripLog Primary"
},
"polyline": example,
"route": "https://www.triplogmileage.com/web/api/trips/xxxxxxxxx/routes",
"receipts": "https://www.triplogmileage.com/web/api/trips/xxxxxxxxx/receipts",
"map": "https://www.triplogmileage.com/web/kml/embed/xxxxxxxxx.kml",
"trackingMethod": "MagicTrip",
"updateMethod": "Updated on the Web",
"CustomField1": "CustomFieldData1",
"stayTimeMins": 86
}

Atualizar Viagem

URL da requisição

Parâmetros de consulta

Nenhum

Dados JSON da requisição

Especifique os campos que deseja alterar. Omitir o campo ou definir como ‘null’ significa nenhuma alteração nesse campo.

{
“tags” : String (optional),
“notes” : String (optional),
“toll” : float (optional),
“parking”: float (optional),
“scale”: float (optional),
“lumpers”: float (optional),
“activity” : String (optional) Business Personal …
}
Respondeu à sua pergunta?