GetContainerPosition

Indique où se trouve un conteneur dans un parc à conteneurs : sa zone et sa position dans les piles, le moment de son dernier mouvement, s’il est vide et l’ordre de travail de ce mouvement. Un système de parc, comme un système de terminal ou de portail, l’utilise pour contrôler un conteneur avant de le déplacer, et enregistre le mouvement avec ExecuteMove. Dans TrakIT, les mêmes informations figurent dans Inventaire du parc et Liste des conteneurs.

Comment envoyer la clé et lire la réponse : Clés d’API, Réponses.

GET /api/public/GetContainerPosition?Cont=ABCU1234560&WHKey=your-yard-key
Authorization: Bearer your-api-key

Envoyez la clé dans un en-tête Authorization avec le schéma Bearer. La clé doit être autorisée à interroger les conteneurs (yard.contquery) ; le support TrakIT s’en charge. Sans cet en-tête, ou avec un autre schéma, TrakIT répond HTTP 401 sans corps.

Paramètre	Obligatoire	Signification
Cont	Oui	Le numéro de conteneur. Lettres, chiffres, - et _ uniquement. Les majuscules n’ont pas d’importance.
WHKey	Oui	La clé du parc, que le support TrakIT vous donne avec la clé d’API. Encodez-la pour l’URL.

Les deux 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
Cont n’est pas vide.	Cont parameter is required
Cont ne contient que des lettres, des chiffres, - et _.	Container Number must be alphanumeric
La requête a un en-tête Authorization: Bearer.	Pas d’Info : HTTP 401 sans corps.
La clé est active et autorisée à interroger les conteneurs.	Key is disabled, not recognized or permission denied
WHKey est la clé d’un parc.	WHKey is missing or invalid
TrakIT connaît le conteneur : il figure dans la liste des conteneurs.	Container ... not found, avec le numéro

Réponse

Une réponse réussie n’est pas l’enveloppe : c’est le conteneur lui-même.

{
  "ContNum": "ABCU1234560",
  "ISO": "45G1",
  "Zone": "Block A",
  "Position": "B4-R2-T1",
  "Bay": 4,
  "Row": 2,
  "Tier": 1,
  "LastMove": "2026-10-20T08:30:12",
  "IsEmpty": false,
  "WOID": 48211
}

Quand TrakIT connaît le conteneur mais qu’il n’est pas dans ce parc, Position vaut Not in yard et les autres champs, à part ContNum et ISO, valent null.

Un refus est l’enveloppe habituelle, avec Code et Info. Testez la présence de ContNum avant de lire le conteneur.

Champ	Signification
ContNum	Le numéro de conteneur.
ISO	Le code de type du conteneur, par exemple 45G1.
Zone	Le nom de la zone où se trouve le conteneur.
Position	La position dans les piles, par exemple B4-R2-T1 pour la travée 4, la rangée 2, le niveau 1. Un conteneur dans le parc sans position dans les piles affiche On Truck si son dernier mouvement était une entrée au parc ou un mouvement sur camion, ou In Zone sinon. Not in yard quand il n’est pas dans ce parc.
Bay, Row, Tier	La travée, la rangée et le niveau de la position dans les piles, ou null s’il n’y en a pas.
LastMove	Le moment où le dernier mouvement du conteneur a été effectué, en UTC. Voir Dates et heures.
IsEmpty	true si le conteneur était vide lors de son dernier mouvement, false s’il était plein.
WOID	L’identifiant de l’ordre de travail lié au dernier mouvement, ou null.