Lister les trajets

URL de la requête

GET https://app.triplog.net/web/api/trips

Paramètres de requête

startDate – Format « aaaa-mm-jj », p. ex. « 2015-01-31 » signifie minuit le 31 janvier 2015 dans votre fuseau horaire local. Inclusif.
endDate – Format « aaaa-mm-jj », p. ex. « 2015-12-31 ». Inclusif.
userEmail – Adresse e-mail d'un utilisateur particulier à rechercher.
activity – Type d'activité du trajet, p. ex. « Business ».
minLastUpdated – Date à laquelle l'enregistrement a été modifié ou créé. Format « aaaa-mm-jj ». Inclusif.
maxLastUpdated – Date à laquelle l'enregistrement a été modifié ou créé. Format « aaaa-mm-jj ». Inclusif.
status – Statut d'approbation. Les options valides sont : « U » – non soumis, « S » – soumis, « A » – approuvé, « R » – rejeté, « P » – paiement programmé.

Remarque

Vous devez fournir au moins un des paramètres de requête dans la demande.
La date/heure renvoyée dans la réponse est exprimée en fuseau horaire UTC, conformément à la norme JSON.

Il existe une limite interne pour la plage de dates, qui la restreint à un an. Lors de la récupération d'une liste de trajets, l'écart entre la date de début et la date de fin doit être inférieur ou égal à 1 an. Si la période est trop grande, un délai d'attente ou un échec de retour est possible.

Exemple

GET https://app.triplog.net/web/api/trips?startDate=2015-01-31&activity=Business

Exemple de réponse

{
      "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

Mettre à jour un trajet

URL de la requête

PUT https://app.triplog.net/web/api/trips[trip_id]

Paramètres de requête

Aucun

Données JSON de la requête

Spécifiez les champs que vous souhaitez modifier. Si un champ est omis ou défini sur « null », aucune modification ne sera apportée à ce champ.

{
"tags" : String (optional),
"notes" : String (optional),
"toll" : float (optional),
"parking": float (optional),
"scale": float (optional),
"lumpers": float (optional),
"activity" : String (optional) Business Personal …
}

API Web – Trajets

Lister les trajets

Mettre à jour un trajet