# Ucis Gest Activity API

Documentazione per le API da utilizzare per inviare il tracking delle attività al Gestionale UCIS.

# Descrizione funzionamento APP

Il funzionamento è descritto sommariamente qui.

# Effettuare le richieste

Il server comunica in HTTPS e ogni richiesta HTTP viene reindirizzata alla sua corrispettiva risorsa criptata. Tutte le richieste devono essere fatte specificando il comando (PUT, POST, DELETE) altrimenti verrà utilizzato GET.

L'URL generico a cui effettuare le richieste è /index.php?option=com_api&app=<APPLICAZIONE>&resource=<RISORSA>&format=raw Dove <APPLICAZIONE> è il nome del gruppo di risorse e <RISORSA> è il nome della risorsa specifica di quell'<APPLICAZIONE>.

Consulta la documentazione di ogni richiesta per conoscere APPLICAZIONE e RISORSA specifici.

# Richieste autenticate

Per le risorse che richiedono all'utente di essere autenticati, appendere key=<TOKEN> all'indirizzo.

Alternativamente, può essere utilizzato l'header http Authorization: Barear <TOKEN>.

# Codici di errore

Una mappa dei codici di errore valida è nel file errorcode.md

# Test & Debug

Per sviluppare l'applicazione e testare le chiamate, consulare questa documentazione

# Compatibiltà client

Client generico HTTP1.1
È possibile utilizzare solamente dispositivi con supporto SNI.
Connessione con certificato SSL obbligatorio