Tralog

Page last edited 831 giorni 10 ore fa
Da wiki.betaingegneria.it.

API tralog[modifica]

Descrizione dell'interfaccia programmatica applicativa (API) REST di TRALOG.

Attenzione!!! Le funzioni sono solo parzialmente REST nel senso che c'è almeno una info che non viene scambiata nell'URL ed è l'id dell'utente che viene reso disponibile al client attraverso lo scambio di cookie di sessione (PHPSESSID).

Se le vogliamo fare veramente REST allora occorre pensare a come controllare l'accesso di volta in volta senza usare la sessione, ad esempio attraverso il rimpallo nell'URL di una chiave univoca creata al momento della login e distrutta al logout o allo scadere di un timeout. Parliamone. Ma per una DEMO penso possa andare bene così.

login[modifica]

autenticazione

http://www.betaingegneria.it/tralog/api/login.php?username=admin&password=admin&device_id=H767A76S7D6D

mission[modifica]

take[modifica]

Creare una missione prendendo in carico una DDT (bolla):

http://www.betaingegneria.it/tralog/api/mission.php?op=take&ddt_id=1

get[modifica]

come ritornare i dettagli di una missione:

basic[modifica]

http://www.betaingegneria.it/tralog/api/mission.php?op=get&ddt_id=11

finalize[modifica]

come terminare una missione.

Quando si finalizza una missione anche la relativa DDT viene chiusa con stato di default (DONE). In futuro penseremo alla funzione per riprenderla in carico (RENEW, stato 3)

basic[modifica]

http://www.betaingegneria.it/tralog/api/mission.php?op=finalize&ddt_id=1

con una non conformità[modifica]

http://www.betaingegneria.it/tralog/api/mission.php?op=finalize&ddt_id=1&noncompliance_id=3

con una nota[modifica]

http://www.betaingegneria.it/tralog/api/mission.php?op=finalize&ddt_id=1&noncompliance_id=3&noncompliance_note=ho+suonato+3+volte

status[modifica]

Elenco degli stati di una missione (utile per per comporre una combobox)

basic[modifica]

http://www.betaingegneria.it/tralog/api/status.php

http://www.betaingegneria.it/tralog/api/status.php?op=list

ritorna un stato in particolare[modifica]

http://www.betaingegneria.it/tralog/api/status.php?op=get&id=1

ddt_status[modifica]

Elenco degli stati di una DDT (utile per per comporre una combobox)

basic[modifica]

http://www.betaingegneria.it/tralog/api/ddt_status.php [DEFAULT]

http://www.betaingegneria.it/tralog/api/ddt_status.php?op=list

ritorna un stato in particolare[modifica]

http://www.betaingegneria.it/tralog/api/ddt_status.php?op=get&id=2