Start data session

General Description

The start-transports endpoint allows you to start (activate) one or more already created transports. This action sets the start date of the transport and marks it as active in the system.

It is subject to the restrictions described in Rate Limit

⚠️ All requests to this endpoint must include the api-version=2.0 parameter in the URL.
URL: POST https://api.trackgps.ro/api/eTransport/start-transports?api-version=2.0


Request Parameters

Requests to this endpoint must be of type POST and include the following parameters:

  • Query parameter:

    • api-version (string, required) – The API version. Recommended value: 2.0
  • Body (JSON):

{
  "transports": [
    {
      "codeUit": "string"
    }
  ]
}
Parameter Type Required Description
transports array Yes List of transports to be started.
codeUit string Yes Unique UIT identifier code of the transport.

🕒 Important: All dates (startDate) must be sent in UTC format.


Response Structure

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

Property Descriptions

Property Type Description
payload boolean Result of the start operation (true if successful).
correlationId string Unique request identifier, useful for traceability.
failureReasons array List of errors (if any), each with code and parameters.
isSuccess boolean Indicates if the request was processed successfully (true or false).

Error Responses

HTTP Code Description
400 Missing, invalid, or incorrectly formatted parameters.
401 Unauthenticated user or insufficient permissions.
429 Rate limit exceeded for the user.