GetAssetLocation

Renvoie l’endroit où se trouve l’un des conteneurs d’un client : la dernière position signalée pour un actif de son ordre de travail, comme le camion qui le transporte, avec le dernier événement que le client peut voir. Le système d’un client l’utilise pour suivre un conteneur. Pour obtenir en une seule fois tous les ordres de travail ouverts du client avec leurs positions, utilisez GetList ; pour les ordres de travail d’un dossier avec leurs détails, utilisez GetShipment.

Dans TrakIT, les actifs sont ajoutés à un ordre de travail dans son encadré Assets, et les positions d’un actif suivi par GPS figurent dans l’onglet Positions de l’actif.

Le point de terminaison ne répond que pour un seul client : l’entité dont la clé est envoyée. Comment envoyer la clé et lire la réponse : Clés d’API des entités, Réponses.

GET /api/public/GetAssetLocation?APIKey=your-entity-key&ContainerNo=ABCU1234560&BookingNo=EXL-2610-0042

Envoyez la clé dans le paramètre APIKey de la chaîne de requête. C’est la propre clé du client : l’API Key affichée sur la page de l’entité quand Enable API Access est activé pour l’entité (voir champs de l’entité). La clé change chaque année, et cesse de fonctionner quand Enable API Access est désactivé : voir Clés d’API des entités. Encodez la clé et les autres valeurs pour l’URL. La clé fait partie de l’adresse : tenez donc ces URL à l’écart des journaux que vous partagez.

Paramètre	Obligatoire	Signification
APIKey	Oui	La clé de l’entité du client.
ContainerNo	Oui	Le numéro du conteneur, tel qu’il figure sur l’ordre de travail. Les majuscules n’ont pas d’importance.
BookingNo	Oui	La référence du dossier du conteneur. Les majuscules n’ont pas d’importance.

Les trois doivent figurer dans la chaîne de requête : sans l’un d’eux, TrakIT répond avec le statut HTTP 404.

Règles

Règle	Info en cas d’échec
APIKey n’est pas vide.	API Key is required
APIKey est la clé d’une entité.	API Key is invalid
La clé est celle de l’année en cours. La clé de chaque entité change le 1er janvier : obtenez la nouvelle sur la page de l’entité.	API Key expiry not found, API Key has expired. Please obtain new key.
L’entité existe.	API Key is invalid
Enable API Access est activé pour l’entité.	API access is disabled

Réponse

En cas de succès, Code vaut 1 et RetInfo est une liste d’au plus un élément : la dernière position enregistrée pour les actifs des ordres de travail correspondants, parmi les dossiers dont le client est l’entité de la clé. RowsAffected vaut 1.

La liste est vide, avec RowsAffected à 0 et Code toujours à 1, quand le client n’a aucun dossier avec cette référence et ce conteneur, ou quand aucun actif de l’ordre de travail n’a signalé de position.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "worder": "",
      "containerno": "ABCU1234560",
      "bookingno": "EXL-2610-0042",
      "gpsdate": "2026-10-20T09:42:00",
      "gpslat": 5.6312,
      "gpslong": -0.0174,
      "event": "Truck departed port",
      "eventstatus": "Y"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Champ	Signification
worder	Toujours vide.
containerno	Le numéro du conteneur.
bookingno	La référence du dossier.
gpsdate	Quand la position a été signalée, en UTC. Voir Dates et heures.
gpslat, gpslong	La latitude et la longitude, en degrés décimaux.
event	Le dernier événement que le client peut voir, sous son nom dans le workflow (le nom de l’événement de référence suivi de son suffixe), et non sous son nom externe. Vide quand l’ordre de travail n’a aucun événement de ce type.
eventstatus	Y quand l’ordre de travail a un événement que le client peut voir, N quand il n’en a aucun.