SeismoCloud API

[] indica un campo opzionale

alive.php

Questo script va chiamato per far sapere al server che il sismometro è attivo e in ascolto di eventuali terremoti; inoltre ad ogni comunicazione il sismometro fornisce al server le proprie coordinate lat lon; infine, se necessario, il server può comunicare le informazioni per effettuare l'update del software del sismometro. Va chiamato appena il sismometro si accende e poi ogni 15 minuti mentre il sismometro è attivo in ascolto di terremoti.

parametri in POST: deviceid lat lon model version [name] [floor] [jsonoutput]

Dove:

Se deviceid è diverso da quello di default (00:00:00:00:c1:a0), restituisce un file nel formato scelto con le seguenti informazioni:

Se deviceid è uguale a 00:00:00:00:c1:a0, il server restituirà solamente il nuovo deviceid che va memorizzato sul device.

terremoto.php

Questo script viene chiamato se il sismometro ha rilevato una vibrazione. Restituisce il numero di secondi di silenzio che il sismometro deve osservare prima di poter chiamare questo script nuovamente.

parametri in POST: deviceid tsstart lat lon

Dove:

Restituisce un intero che indica il tempo (in secondi) durante il quale ignorare ogni vibrazione.

owner.php

Questo servizio permette di inizializzare, cancellare o modificare la configurazione di un sismometro. In caso di modifica o cancellazione. l'uuid dell'owner deve corrispondere a quello utilizzato per la creazione.

parametri in POST: phoneid deviceid label [lat lon floor model version] [delete]

Dove:

Se specificato il parametro delete=1 il sismometro viene eliminato dal database. In questo caso i campi label, lat, lon, floor, version e model vengono ignorati. Restituisce un json con l'esito true o false dell'operazione.

pairing.php

Questo servizio permette di abbinare un sismometro (già inizializzato) a un altro telefono

parametri in POST: phoneid deviceid label

Dove:

Se specificato il parametro delete=1 il pairing viene eliminato. In questo caso il parametro label. Restituisce un json con l'esito true o false dell'operazione.

tuoisismometri.php

Questo servizio restituisce i sismometri abbinati al telefono o di cui il telefono รจ owner, con lo storico delle ultime 32 rilevazioni.

parametri in GET: [phoneid] [deviceid]

Dove:

Se non &egrave specificato deviceid, restituisce un json contenente l'elenco di sismometri (owned o associati) con i relativi storici; se non &egrave specificato phoneid, restituisce un json contenente i dati principali del sismometro deviceid; se sono specificati sia deviceid che phoneid, restituisce un json contenente esclusivamente lo storico di quel device.

register.php

Questo servizio registra un telefono per le push.

parametri in POST: phoneid regid prov

Dove:

addtoscuola.php

Questo servizio registra un telefono ad una certa scuola.

parametri in POST: phoneid idscuola scuolapass

Dove:

Restituisce un json con l'esito true o false dell'operazione.


API per il sito delle scuole

createscuola.php

Questo servizio registra una scuola.

parametri in POST: idscuola scuolapass nome provincia

Dove:

Restituisce un json con l'esito true o false dell'operazione.

scuolapass.php

Questo servizio permette di modificare la password pubblica della scuola.

parametri in POST: idscuola scuolapass scuolaoldpass

Dove:

Restituisce un json con l'esito true (1) o false (0) dell'operazione.

scuola.php

Questo servizio restituisce i sismometri della scuola con la loro attività.

parametri in GET: idscuola scuolapass

Dove:

Restituisce un json con le informazioni per ogni device: lat,lon,acceso,status. Acceso=1 indica che il sismometro è acceso e funzionante. Se status=1 il sismometro ha rilevato una vibrazione negli ultimi 5 secondi.

lista.php

Questo servizio restituisce gli eventi sismici rilevanti per la scuola

parametri in GET: idscuola scuolapass lat lon

Dove:

Restituisce un json con le informazioni per ogni evento e il numero di sismometri che hanno vibrato per quell'evento