Ir al contenido principal

API Web – Viajes

Listar viajes

URL de la solicitud

Parámetros de consulta

  • startDate – Formato "aaaa-mm-dd", p. ej. "2015-01-31" significa medianoche del 31 de enero de 2015 en su zona horaria local. Inclusive.

  • endDate – Formato "aaaa-mm-dd", p. ej. "2015-12-31". Inclusive.

  • userEmail – Dirección de correo electrónico de un usuario específico a buscar.

  • activity – Actividad del viaje, p. ej. "Business".

  • minLastUpdated – Fecha en que se modificó o creó el registro. Formato "aaaa-mm-dd". Inclusive.

  • maxLastUpdated – Fecha en que se modificó o creó el registro. Formato "aaaa-mm-dd". Inclusive.

  • status – Estado de aprobación. Las opciones válidas son: "U" – no enviado, "S" – enviado, "A" – aprobado, "R" – rechazado, "P" – pago programado.

Nota

Debe proporcionar al menos uno de los parámetros de consulta en la solicitud.
La fecha y hora devueltas en la respuesta están en la zona horaria UTC, según el estándar JSON.

Existe un límite interno para el rango de fechas, que lo restringe a un año. Al obtener una lista de viajes, la diferencia entre la fecha de inicio y la fecha de fin debe ser menor o igual a 1 año. Si el período es demasiado amplio, es posible que se produzca un tiempo de espera agotado o un error en la respuesta.

Ejemplo

Ejemplo de respuesta

{
"id": 999999,
"url": "https://app.triplog.net/web/api/trips/999999",
"lastUpdated": "2023-09-18T19:25:29.049Z",
"user": {
"id": 000003,
"url": "https://app.triplog.net/web/api/users/000003",
"email": "user@triplog.net",
"display": "User, Demo"
},
"vehicle": {
"id": 222222,
"url": "https://app.triplog.net/web/api/vehicles/222222",
"lastUpdated": "2023-03-27T22:37:01.417Z",
"display": "2018 Default Vehicle "
},
"startTime": "2023-09-06T00:34:00.000Z",
"endTime": "2023-09-06T01:00:00.000Z",
"startOdometer": 618,
"endOdometer": 631,
"mileage": 13.4,
"fromLocation": {
"id": 333333,
"url": "https://app.triplog.net/web/api/locations/333333",
"lastUpdated": "2023-04-21T19:43:00.913Z",
"display": "FW Greens",
"name": "FW Greens",
"address": "1234 N Main St, AnytownUSA, NC 12345"
},
"toLocation": {
"id": 444444,
"url": "https://app.triplog.net/web/api/locations/444444",
"lastUpdated": "2023-08-02T01:13:05.783Z",
"display": "4321 Front St, AnytownUSA, NC 12345",
"name": null,
"address": "4321 Front St, AnytownUSA, NC 12345"
},
"activity": "Business",
"parking": 0.0,
"toll": 0.0,
"tags": null,
"notes": null,
"status": "S",
"statusUpdateTime": "2023-09-18T19:25:29.000Z",
"statusUpdatedBy": {
"id": 000002,
"url": "https://app.triplog.net/web/api/users/000002",
"email": "admin@triplog.net",
"display": "User, Admin"
},
"polyline": null,
"route": "https://app.triplog.net/web/api/trips/xxxxxx/routes",
"receipts": "https://app.triplog.net/web/api/trips/xxxxxx/receipts",
"map": "https://app.triplog.net/web/kml/embed/xxxxxx.kml",
"trackingMethod": "MagicTrip",
"updateMethod": null,
"scale": 0.0,
"lumpers": 0.0,
"perDiem": false,
"stayTimeMins": 50191

Actualizar viaje

URL de la solicitud

Parámetros de consulta

Ninguno

Datos JSON de la solicitud

Especifique los campos que desea modificar. Omitirlo o establecerlo en "null" significa que no habrá cambios en ese campo.

{
"tags" : String (optional),
"notes" : String (optional),
"toll" : float (optional),
"parking": float (optional),
"scale": float (optional),
"lumpers": float (optional),
"activity" : String (optional) Business Personal …
}
¿Ha quedado contestada tu pregunta?