Start sesiune date

Descriere Generală

Endpoint-ul start-transports permite pornirea (activarea) unuia sau mai multor transporturi deja create. Această acțiune setează data de început a transportului și îl marchează ca fiind activ în sistem.

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

Parametri Cerere

Cererile către acest endpoint trebuie să fie de tip POST și să includă următorii parametri:

  • Parametru de query:

    • api-version (string, obligatoriu) – Versiunea API-ului. Valoare recomandată: 2.0

  • Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Parametru Tip Obligatoriu Descriere
transports array Da Lista transporturilor ce urmează să fie pornite.
codeUit string Da Codul unic de identificare UIT al transportului.

🕒 Important: Toate datele (startDate) trebuie trimise în format UTC.

Structura Răspunsului

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

Descrierea Proprietăților

Proprietate Tip Descriere
payload boolean Rezultatul operației de pornire (true dacă a reușit).
correlationId string Identificator unic al cererii, util pentru trasabilitate.
failureReasons array Lista cu erori apărute (dacă există), fiecare cu cod și parametri.
isSuccess boolean Indică dacă cererea a fost procesată cu succes (true sau false).

Răspunsuri de Eroare

Cod HTTP Descriere
400 Parametri lipsă, invalidi sau format incorect.
401 Utilizator neautentificat sau fără permisiuni.
429 A fost depășit rate limit-ul pentru utilizator.