Polling

IntentPlatform vous permet de réaliser un polling afin de récupérer les tickets qui vous concernent et dont vous n'êtes pas le créateur, et donc de gérer le cas d'usage des demandes d'intervention.

Informations générales

API à utiliser : API Operations v2
Méthode : GET

Déroulé

Vous allez réaliser un appel API régulier afin de récupérer tous les nouveaux tickets et ceux mis à jour depuis la dernière fois.

Dans le retour API, vous allez récupérer :
  • la référence du ticket
  • son créateur (issuer)
  • le contrat
  • les logs

Un log traduit une étape d'une intervention. Toutes les étapes de l'intervention (création, planification, début/fin d'intervention, annulation, clôture, etc.) seront disponibles dans la rubiruqe logs du json.
Plus d'informations sur les logs :  Demande d'intervention  (Qu'est-ce qu'un log?)

Solution technique

Récupération des informations

API operations v2
Méthode : GET
Paramètres : since={date} ; notIssuedByMe=true ; fields=logs
/api/operations/v2/operations?since=2021-06-01T10:00:00&notIssuedByMe=true&fields=logs

Le paramètre since vous permet de récupérer tous les nouveaux tickets ou les tickets ayant eu des nouveautés depuis la date indiquée dans le paramètre since.

Le paramètre notIssuedByMe=true permet d'indiquer que vous souhaitez récupérer tous les tickets dont vous n'êtes pas le créateur.

Le paramètre fields=logs vous permet de récupérer le détail de chaque événement du ticket.