Pauză sesiune date

Descriere Generală

Endpoint-ul pause-transports permite întreruperea transmiterii poziţiei unui transport activ, pe baza codului UIT. Similar cu start și stop, transporturile sunt întrerupte temporar.

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

Parametrii 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 puse pe pauză.
codeUit	string	Da	Codul unic de identificare UIT al transportului.

Structura Răspunsului

{
  "payload": true,
  "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 pauză (`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 parametrii.
isSuccess	boolean	Indică dacă cererea a fost procesată cu succes (`true` sau `false`).

Răspunsuri de Eroare

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