Liste des tickets et mise à jour des statuts

Dernière mise à jour : 13/02/2019 22:56:53

Les APIs Facility Management sont dédiées à la gestion et transmissions des demandes entre GEOLYS et des systèmes externes.

L'API Facility Management est accessible à cette adresse :

https://api-fm.geolys.io/api/{endpoint}/?apikey=xxxxx
  • endpoint : point de terminaison à contacter (cliquez-ici pour la liste)
  • apikey : clé d'API spécifique FM fournie pour autoriser les appels à ce point d'API*

Exemple d'appel complet :

GET https://api-fm.geolys.io/api/active/?apikey=xxxxx

* GEOLYS intègre une base d'API KEY avec affectation de droit par API. Il est donc possible d'avoir la même API KEY pour plusieurs usages (calcul d'itinéraire, meeting, etc.)

 

L'API est en évolution constante pour ajouter de nouveaux EndPoints.

Récupérer la liste des tickets en cours

Requête

GET /api/active/{provider}/
  • provider : nom du fournisseur externe. Permet à nos "bots workers" de différencier la source de mise à jour et d'appliquer éventuellement des traitements particuliers (mappages, transformation de données, etc.)

Options

  • skip[optionnal] : id of the last item
  • top[optionnal] : nb items to display, default 100 (SP default)

Résultats

{
  "success": true,
  "messageIfError": null,
  "datas": [
    {
      "id": 2,
      "externalID": null,
      "status": null,
      "dateStatus": null,
      "description": "<div class=\"ExternalClass1911BBBBD56345FF9936BF11359BEDC5\">Nd’nd dn</div>",
      "title": "Poubelle tst",
      "geoloc": "172/2.281537/48.848400/1/0",
      "emmergencyLevel": "Moyen",
      "subCateg": null
    },
    {
      "id": 3,
      "externalID": null,
      "status": null,
      "dateStatus": null,
      "description": "<div class=\"ExternalClass5FF5DD1CF1DD471097CFEE521C4E97DD\">Description </div>",
      "title": "Pb de climatisation ",
      "geoloc": "172/2.281530/48.848503/1/2",
      "emmergencyLevel": "Elevé",
      "subCateg": null
    }
  ]
}

Mise à jour d'un statut par un système externe

Requête

PUT /api/tickets/updateticketstatusfromexternal/{provider}
  • provider : nom du fournisseur externe. Permet à nos "bots workers" de différencier la source de mise à jour et d'appliquer éventuellement des traitements particuliers (mappages, transformation de données, etc.)

Corps

{
  ExternalID : 54612,
  Statut : 'TERMINE',
  DateStatut : '2018-02-18T12:10:13',
  Description : 'description'
}
  • ExternalID : ID externe du ticket (côté GEOLYS celui-ci a été conservé lors de la création/transmission du ticket au système externe)
  • Statut : statut modifié de la demande (un mappage est possible selon le provider source. Par ex : 'terminé', 'en cours')
  • DateStatut : date de changement du statut (format UTC si possible)
  • Description : commentaire lié au traitement du ticket

Sommaire

Support