GetList

Devuelve una lista para el cliente cuya clave se envía. Hay una sola lista, AssetLocations: todas las órdenes de trabajo abiertas de los expedientes del cliente, con la última posición comunicada para un activo de cada una, como el camión que transporta el contenedor. El sistema de un cliente lo usa para mostrar todos sus contenedores en un mapa a la vez. Para un solo contenedor, con el último evento que puede ver el cliente, use GetAssetLocation.

En TrakIT, los activos se añaden a una orden de trabajo en su recuadro Assets, y las posiciones de un activo con GPS están en la pestaña Positions del activo.

Cómo enviar la clave y leer la respuesta: Claves de API de las entidades, Respuestas.

GET /api/public/GetList?APIKey=your-entity-key&ListType=AssetLocations

Envíe la clave en el parámetro APIKey de la cadena de consulta. Es la clave propia del cliente: la API Key que se muestra en la página de la entidad cuando Enable API Access está activado para la entidad (consulte campos de la entidad). Codifíquela para URL. La clave forma parte de la dirección, así que no incluya estas URL en los registros que comparta.

Parámetro	Obligatorio	Significado
APIKey	Sí	La clave de la entidad del cliente, la del año en curso.
ListType	Sí	La lista que se devuelve: AssetLocations, la única. Las mayúsculas no importan.

Los dos deben estar en la cadena de consulta: sin uno de ellos, TrakIT responde HTTP 404.

Reglas

Regla	Info si no se cumple
APIKey no está vacío.	API Key is required
APIKey es una clave emitida por TrakIT.	API Key is invalid
La clave es la de este año. La clave de cada entidad cambia el 1 de enero: obtenga la nueva en la página de la entidad.	API Key expiry not found, API Key has expired. Please obtain new key.
La clave es la de una entidad.	Expecting numeric ID, Invalid Key Type
La entidad existe.	No such entity
Enable API Access está activado para la entidad.	API access is disabled
ListType es AssetLocations.	Invalid List Type

Respuesta

Si tiene éxito, Code es 1, RetInfo lista las órdenes de trabajo abiertas de los expedientes cuyo cliente es la entidad de la clave, y RowsAffected indica cuántas son. Abiertas significa activas o abandonadas: las órdenes de trabajo cerradas y canceladas quedan fuera (consulte Cerrar, cancelar o reabrir). La lista se ordena por número de contenedor y, después, por referencia del expediente.

También se lista una orden de trabajo cuyos activos no han comunicado ninguna posición, con los campos de posición a null. Si no hay órdenes de trabajo abiertas, RetInfo es una lista vacía y RowsAffected es 0.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "containerno": "ABCU1234560",
      "bookingno": "EXL-2610-0042",
      "gpsdate": "2026-10-20T09:42:00",
      "gpslat": 5.6312,
      "gpslong": -0.0174
    },
    {
      "containerno": "ABCU7654321",
      "bookingno": "EXL-2610-0042",
      "gpsdate": null,
      "gpslat": null,
      "gpslong": null
    }
  ],
  "RowsAffected": 2,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
containerno	El número de contenedor de la orden de trabajo.
bookingno	La referencia del expediente.
gpsdate	Cuándo se comunicó la última posición de un activo de la orden de trabajo, en UTC. Consulte Fechas y horas.
gpslat, gpslong	La latitud y la longitud de esa posición, en grados decimales.