Ștergere transporturi

Descriere Generală

Endpoint-ul remove-transports permite ștergerea unuia sau mai multor transporturi din sistem, pe baza identificatorilor unici (transportUId). Această acțiune este ireversibilă și necesită drepturi de acces corespunzătoare asupra transporturilor vizate.

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/remove-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):

{
  "transportsUids": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  ]
}
Parametru Tip Obligatoriu Descriere
transportsUids array Da Lista de identificatori unici (GUID) ai transporturilor ce urmează a fi șterse.

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 ștergere (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.