Alimentări

Descriere Generală

Metoda Refills returnează o listă cu evenimentele de alimentare sau scădere a nivelului de carburant detectate în perioada pentru care se face apelul. Aceasta returnează doar datele pentru vehiculele la care utilizatorul are acces.
În cazul în care lista conține cel puțin un vehicul la care utilizatorul nu are acces, se va returna un răspuns cu cod de eroare 401.

Este supus restricțiilor din Rate Limit

⚠️ Toate cererile către acest endpoint trebuie să includă parametrul api-version=2.0 în URL.
URL: POST https://api.trackgps.ro/api/carriers/refills?api-version=2.0

⚠️ Notă: Toate datele calendaristice transmise sau returnate de acest endpoint sunt în fusul orar local al companiei.

Parametri Request

{
  "carrierId": 0,
  "startDate": "2024-09-09T09:42:51.835",
  "endDate": "2024-09-09T09:42:51.835"
}
  • carrierId: ID-ul unic al vehiculului pentru care se dorește obținerea evenimentelor de alimentare sau scădere a nivelului de carburant.
  • startDate: Data și ora de început a perioadei pentru care se solicită evenimentele.
  • endDate: Data și ora de sfârșit a perioadei pentru care se solicită evenimentele.

Structura Răspunsului

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

Descrierea Proprietăților

  • payload: Lista evenimentelor de alimentare sau scădere a nivelului de carburant.
    • date: Data și ora evenimentului.
    • event: Tipul evenimentului (alimentare sau scădere a nivelului de carburant).
    • location: Locația unde a avut loc evenimentul.
    • estimation: Estimarea cantității de carburant implicate în eveniment.
    • isPrivate: Indicator dacă evenimentul s-a efectuat în mod privat.
  • correlationId: ID-ul unic pentru corelarea cererii și răspunsului.
  • failureReasons: Lista motivelor de eșec, dacă există.
    • errorCode: Codul de eroare.
    • errorParameters: Parametrii suplimentari pentru eroare.
  • isSuccess: Indicator dacă cererea a fost procesată cu succes.

Lista Posibile Evenimente

  • FuelStart: Nivel început
  • Fueling: Alimentare
  • PossibleFuelTheft: Posibil furt de carburant
  • TotalRefill: Total alimentări
  • TotalPossibleTheft: Total posibile furturi de carburant
  • RemainingFuel: Carburant rămas
  • TotalFuelConsumption: Consum total de carburant
  • FuelStartSecondarySource: Începutul alimentării din sursă secundară
  • FuelingSecondarySource: Alimentare din sursă secundară
  • PossibleFuelTheftSecondarySource: Posibil furt de carburant din sursă secundară
  • TotalRefillSecondarySource: Total alimentări din sursă secundară
  • TotalPossibleTheftSecondarySource: Total posibile furturi din sursă secundară
  • RemainingFuelSecondarySource: Carburant rămas din sursă secundară
  • TotalFuelConsumptionSecondarySource: Consum total de carburant din sursă secundară