Electronic Personnel Attendance System

Documenti pubblici, digitali.

8.4. Consultazione Uffici via REST

Di seguito una breve spiegazione dell'API REST relativa alla consultazione della lista delle sedi preesnti nel sistema.

Gli esempi sono per semplicità basati sulla httpie ed utilizzano la demo disponibile all'indirizzo https://epas-demo.devel.iit.cnr.it .

8.4.1. Permessi

Per poter accedere a queste interfaccie REST è necessario utilizzare un utente che abbia uno dei seguenti ruoli di sistema Consultatore riepiloghi orari e assenze, Developer, Amministratore e dalla versione 2.15.0 anche dei ruoli Gestore assenze e Gestore anagrafica.

Gli utenti di sistema non possono essere creati dalle singole sedi ma da un utente con ruolo

Amministratore di ePAS.

L'autenticazione da utilizzare è come per gli altri servizi REST quella Basic Auth.

8.4.2. Office List

Per ottenere la lista degli uffici attivi è possibile effettuara una HTTP GET all'indirizzo /rest/v3/offices/all.

È possibile indicare una data di riferimento per indicare gli uffici attivi in quella data:

  • atDate (in formato aaaa-mm-gg).

$ http -a registry_manager
    GET https://epas-demo.devel.iit.cnr.it/rest/v3/offices/all atDate==2024-01-01
[
  {
      "address": "Via Moruzzi 1, Pisa",
      "beginDate": "2012-07-30",
      "code": "044000",
      "codeId": "223400",
      "endDate": null,
      "headQuarter": false,
      "id": 1,
      "instituteId": 1,
      "joiningDate": null,
      "name": "IIT - Pisa",
      "perseoId": 180,
      "updatedAt": "2022-03-15T11:42:53.909061"
  }
]