GetAssetsUpdated

Liste les actifs d’un type d’actif dont les détails ont été modifiés sur une période, avec leur identifiant, leur numéro de série et leur nom. Une intégration qui tient sa propre copie de vos camions, remorques ou autres équipements l’appelle à intervalles réguliers, puis lit chaque actif listé avec GetAsset.

Comment se connecter et lire la réponse : Authentification, Réponses.

GET /api/v1/GetAssetsUpdated?AssetType=1&FromDate=2026-10-01&ToDate=2026-10-31T23:59:59
Token: your-token

Paramètre	Obligatoire	Signification
AssetType	Oui	L’identifiant du type d’actif, un nombre entier de 1 à 255. GetAsset le renvoie dans TypeID.
FromDate	Oui	Le début de la période, en UTC : une date, yyyy-MM-dd, ou une date et une heure, yyyy-MM-ddTHH:mm:ss.
ToDate	Oui	La fin de la période, en UTC, sous la même forme. 365 jours au plus après FromDate.

• Envoyez les trois paramètres. Sans l’un d’eux, la requête n’atteint pas le point de terminaison, et TrakIT répond avec le statut HTTP 404 (voir Erreurs).
• Les deux bornes sont incluses. Une date sans heure correspond à minuit au début de ce jour : ToDate=2026-10-31 exclut donc les modifications faites plus tard le 31 octobre. Pour inclure toute cette journée, envoyez 2026-10-31T23:59:59 ou 2026-11-01.
• Écrivez une heure avec le T, comme ci-dessus. TrakIT supprime les espaces des dates : 2026-10-31 23:59:59 est donc refusé. Voir Dates et heures.

Ce qui compte comme une modification

Un actif est listé quand ses détails ont été modifiés pour la dernière fois au cours de la période : avec Edit Detail sur la page de l’actif ou par une importation, ou quand il a été réformé.

Ne comptent pas : l’ajout de l’actif, le fait de le lier ou de le délier, et les modifications de ses champs d’actif, sociétés, fichiers ou positions. Un nouvel actif n’est listé qu’une fois ses détails modifiés pour la première fois.

Seule la dernière modification compte : un actif modifié pendant votre période puis de nouveau après n’est listé que dans la période ultérieure. Demandez des périodes consécutives, chacune commençant là où la précédente s’est terminée, et chaque actif dont les détails changent est listé au moins une fois.

Règles

Règle	Info en cas d’échec
L’en-tête Token contient un jeton valide.	Token missing in header, Token invalid or expired, ou une autre réponse listée dans Jeton de connexion
L’utilisateur est un administrateur système disposant de l’accès à l’API.	API User must be SysAdmin with API Access
FromDate n’est pas vide.	FromDate is required
ToDate n’est pas vide.	ToDate is required
AssetType est un nombre entier de 1 à 255.	Asset Type is invalid
FromDate est une date.	FromDate is not valid
ToDate est une date.	ToDate is not valid
ToDate n’est pas antérieure à FromDate.	ToDate must be later than FromDate
Les dates sont espacées de 365 jours au plus.	Days between FromDate and ToDate cannot exceed 365

Réponse

En cas de succès, RetInfo liste les actifs, par ordre d’identifiant, et RowsAffected indique leur nombre. La liste contient les actifs de toutes les sociétés, quel que soit leur statut.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    { "AssetID": 48211, "AssetSerial": "EXTRK012", "AssetName": "Truck 12" },
    { "AssetID": 48236, "AssetSerial": "EXTRK015", "AssetName": "Truck 15" }
  ],
  "RowsAffected": 2,
  "Scalar": null,
  "Identity": 0
}

Champ	Signification
AssetID	L’identifiant de l’actif. Lisez l’actif avec GetAsset.
AssetSerial	Le numéro de série de l’actif (Serial).
AssetName	Le nom de l’actif (Name).

Quand aucun actif du type n’a été modifié pendant la période, ou qu’aucun type d’actif n’a cet identifiant, la réponse a Code 0 et Info No data found.