Generale

Le REST API di Cometa mettono a disposizione diverse funzionalità

Il token di autenticazione viene restituito dal metodo di login ed ha una sua validità temporale.
Il token deve essere passato generalmente nell'header della richiesta col nome: "token". E' richiesto per tutti i metodi eccetto login
Alternativamente il token può essere passato anche come parametro "token" nell'url della richiesta, utile quando non si può passare nessun header alla richiesta.
Si può verificare la validità del token con il metodo checktoken.
Se il token è scaduto occorre recuperarne un'altro semplicemente effettuando il login.

Metodi presenti un questa sezione:

• login metodo per effettuare l'autenticazione
• checkToken metodo per verificare la validità del token

METODO	HTTP Verb	PARAMETRI	RISULTATO
login	POST, GET	application/json { "username":"", "password":"", "id": "" } <b>valore dei parametri</b> <table border="0" style="border:1px solid #999; border-collapse:collapse"> <tr> <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>parametro</th> <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>descrizione</th> <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>default</th> <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>obbligatorio</th> </tr> <tr> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>username</b></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>nome utente login</td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td> </tr> <tr> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>password</b></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>password utente login</td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td> </tr> <tr> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>id</b></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>codice Cliente di Cometa</td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td> <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>SI</td> </tr> </table>	Il metodo ritorna il seguente oggetto JSON: { "token": "541bee22-edf2-4c04-98a1-66222b55d759", "passwordDaCambiare": false, "nominativo": "ACCENTURE", "clienteCometa": "OCN", "cliente": true, "utente": false, "capoProgetto": true, "responsabileDiStruttura": true, "approvatoreGiustificativi": true, "scadenza": "2020-03-25T12:20:18.0881294+01:00", "moduliAbilitati": [ "TASKS" ], "permessi": [ { "nome": "Cometa Cliente", "descrizione": "Accesso come Cliente", "inserimento": true, "lettura": true, "modifica": true, "eliminazione": true, "esecuzione": true } ] } token: è il token di autenticazione necessario da passare nell'header delle api che lo richiedono passwordDaCambiare: obbligo per l'utente di cambiare la password nominativo: Nominativo dell'utente/cliente di cliente collegato clienteCometa: nome del cliente dell'istanza di Cometa cliente: true se chi si collega è un cliente di cliente Cometa utente: true se chi si collega è un utente di cliente Cometa permessi: un array di oggetti che rappresentano i permessi associati all'utente collegato
checkToken	POST, GET		Il metodo ritorna il seguente oggetto JSON: { "valido": true, "nominativo": "Parenti Emanuele", "clienteCometa": "OCN", "cliente": false, "utente": false, "capoProgetto": true, "responsabileDiStruttura": true, "approvatoreGiustificativi": true, "moduliAbilitati": [ "TASKS" ], "permessi": [ { "nome": "Documenti", "descrizione": "", "inserimento": true, "lettura": true, "modifica": true, "eliminazione": true, "esecuzione": true }, { "nome": "Giustificativi", "descrizione": "", "inserimento": false, "lettura": false, "modifica": false, "eliminazione": false, "esecuzione": true }, { "nome": "Inserimento ore", "descrizione": "", "inserimento": true, "lettura": true, "modifica": true, "eliminazione": true, "esecuzione": true }, { "nome": "Rubrica", "descrizione": "", "inserimento": false, "lettura": false, "modifica": false, "eliminazione": false, "esecuzione": false } ] } valido: true se il token è ancora valido