Adatküldési munkamenet indítása

Általános leírás

A start-transports végpont lehetővé teszi egy vagy több már létrehozott fuvar indítását (aktiválását). Ez a művelet beállítja a fuvar kezdő dátumát, és aktívként jelöli a rendszerben.

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/eTransport/start-transports?api-version=2.0


Kérés paraméterei

A végponthoz küldött kéréseknek POST típusúnak kell lenniük, és a következő paramétereket kell tartalmazniuk:

  • Query paraméter:

    • api-version (string, kötelező) – Az API verziója. Ajánlott érték: 2.0
  • Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Paraméter Típus Kötelező Leírás
transports array Igen Az indítandó fuvarok listája.
codeUit string Igen A fuvar egyedi UIT azonosító kódja.

🕒 Fontos: Minden dátumot (startDate) UTC formátumban kell megadni.


Válasz szerkezete

{
  "payload": {
    "codeUit": "string",
    "isSuccess": true,
    "errors": [
      "string"
    ]
  },
  "correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "failureReasons": [
    {
      "errorCode": "string",
      "errorParameters": [
        "string"
      ]
    }
  ],
  "isSuccess": true
}

Tulajdonságok leírása

Tulajdonság Típus Leírás
payload boolean Az indítás eredménye (true, ha sikeres volt).
correlationId string Egyedi kérésazonosító, nyomon követéshez hasznos.
failureReasons array Hibák listája (ha vannak), mindegyik tartalmaz kódot és paramétereket.
isSuccess boolean Jelzi, hogy a kérés sikeresen feldolgozásra került-e (true vagy false).

Hibaválaszok

HTTP kód Leírás
400 Hiányzó, érvénytelen vagy hibás formátumú paraméterek.
401 Nem hitelesített vagy jogosulatlan felhasználó.
429 A felhasználó túllépte a rate limit-et.