fret/update

Cette fonction est vitale dans le sens Equinoxe => TMS. Elle est a exécuter à intervalle régulier. Par exemple toutes les 5 minutes.

Elle nécessite un paramètre sans lequel elle ne peux pas fonctionner. Un timestamp au format Unix. Plus d’informations ici.

Elle retourne les numéros chrono qui ont été modifiés, créés depuis la dernière fois qu’elle a été exécutée.

Il faut savoir que chaque action ou évènement effectué sur une offre quel qu’il soit modifie le timestamp de cette offre. De sorte que dès que cette requête est effectuée, Equinoxe retourne le numéro chrono de l’offre et vous permet de mettre à jour le TMS avec les nouvelles informations. Voici un outil permettant la conversion dans les deux sens de ce timestamp.

Exemple, nous sommes le 10/01/2022 et il est 14h00, cela nous donne un timestamp de 1641819600. Pour obtenir les « nouveautés » des offres qui vous concerne il faut prendre ce timestamp, lui enlever 5 minutes, et interroger Equinoxe avec ce timestamp. Ce qui donnerai : 1641819300.

Equinoxe vous retourne donc tous les numéros chrono des offres où il y a eu une modification ou évènement durant les 5 dernières minutes.

Ensuite vous pouvez effectuer la requête fret/infos pour obtenir concrètement les informations de ces offres.

Naturellement cette fonction retourne uniquement les offres qui vous concernent.

Attention à ne pas envoyer un timestamp trop loin dans le temps car le nombre de numéros retournés est limité et vous risquez d’obtenir un message d’erreur du type Erreur interne « 500 ». Cela s’est déjà produit lorsque certains d’entre vous ont essayé d’importer des offres trop anciennes. Concrètement si nous sommes le 10/01/2022, vous ne pourrez pas importer les offres depuis le 10/01/2021.

Sachez que même si vous nous envoyez un timestamp qui correspondrait pile à l’heure courante, nous prenons l’initiative de le modifier et de lui enlever 2 heures. Par précaution… Vous ne devriez donc rien manquer.