Tankolások

Általános leírás

A Refills metódus visszaadja a megadott időszakban észlelt tankolási vagy üzemanyagszint-csökkenési események listáját. Csak azokhoz a járművekhez tartozó adatokat adja vissza, amelyekhez a felhasználónak hozzáférése van.
Ha a lista legalább egy olyan járművet tartalmaz, amelyhez a felhasználónak nincs hozzáférése, 401 hibakódú válasz érkezik.

A Rate Limit korlátozásai érvényesek.

⚠️ Minden kéréshez ehhez a végponthoz kötelező az api-version=2.0 paramétert megadni az URL-ben.
URL: POST https://api.trackgps.ro/api/carriers/refills?api-version=2.0

⚠️️ Megjegyzés: Az ezen végponthoz küldött vagy onnan kapott minden dátum- és időérték a vállalat helyi időzónájában van megadva.

Request paraméterek

{
  "carrierId": 0,
  "startDate": "2024-09-09T09:42:51.835",
  "endDate": "2024-09-09T09:42:51.835"
}

• carrierId: Annak a járműnek az egyedi azonosítója, amelyhez tankolási vagy üzemanyagszint-csökkenési eseményeket szeretnénk lekérni.
• startDate: Az időszak kezdő dátuma és ideje, amelyre az eseményeket kérjük.
• endDate: Az időszak záró dátuma és ideje, amelyre az eseményeket kérjük.

Válasz szerkezete

{
  "payload": [
    {
      "date": "string",
      "event": "string",
      "location": "string",
      "estimation": 0,
      "isPrivate": true
    }
  ],
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

• payload: A tankolási vagy üzemanyagszint-csökkenési események listája.
  • date: Az esemény dátuma és ideje.
  • event: Az esemény típusa (tankolás vagy üzemanyagszint-csökkenés).
  • location: Az esemény helyszíne.
  • estimation: Az eseményhez kapcsolódó üzemanyag mennyiségének becslése.
  • isPrivate: Jelzi, hogy az esemény magáncélú volt-e.
• correlationId: Egyedi azonosító a kérés és válasz összekapcsolásához.
• failureReasons: A hibák listája, ha vannak.
  • errorCode: Hibakód.
  • errorParameters: Hibához tartozó további paraméterek.
• isSuccess: Jelzi, hogy a kérés sikeresen feldolgozásra került-e.

Lehetséges eseménytípusok listája

• FuelStart: Kezdő szint
• Fueling: Tankolás
• PossibleFuelTheft: Lehetséges üzemanyaglopás
• TotalRefill: Összes tankolás
• TotalPossibleTheft: Összes lehetséges üzemanyaglopás
• RemainingFuel: Maradék üzemanyag
• TotalFuelConsumption: Teljes üzemanyag-fogyasztás
• FuelStartSecondarySource: Másodlagos forrás kezdő szintje
• FuelingSecondarySource: Tankolás másodlagos forrásból
• PossibleFuelTheftSecondarySource: Lehetséges üzemanyaglopás másodlagos forrásból
• TotalRefillSecondarySource: Összes tankolás másodlagos forrásból
• TotalPossibleTheftSecondarySource: Összes lehetséges lopás másodlagos forrásból
• RemainingFuelSecondarySource: Maradék üzemanyag másodlagos forrásból
• TotalFuelConsumptionSecondarySource: Teljes üzemanyag-fogyasztás másodlagos forrásból