Fenice Api
BUILDS accesso alle informazioni BUILD
Padre di FLOORS, ROOMS

Gli EDIFICI rappresenta un costrutto fatto da piani se stanze, fisiche. In FENICE, l'accesso all'edificio è regolamentato dalle autorizzazioni che ogni utente possiede a livello di commessa.

Le autorizzazioni sono definite a livello di ogni progetto. Fare riferimento a FENICE per vedere cosa disporre a livello di consultazione, programma personalizzato.

GET personaldata/builds
Descrizione: ritorna elenco Tabella siti
Dati della tabella:
id
integer
RO
Codice auto incrementale univoco fornito dal sistema.
codice
varchar(60)
Codice univoco assegnato dal cliente (non duplicabile).
descrizione
varchar(255)
Descrizione semplice.
site_id
integer
Relazione con tabella Sites. SITE_ID deve esistere per mantenere la relazione.
indirizzo
varchar(255)
Informazione ad uso funzionale.
note
text
Informazione ESTESA ad uso funzionale.
autore
varchar(255)
RO
Utente che ha registrato il record.
revisore
varchar(255)
RO
Ultimo utente che ha aggiornato il record.
attivo
boolean
Stato del dato, se false dato non utilizzato (come cancellato).
disattivato
varchar(255)
RO
Utente che ha disattivato il dato.
extra_contratto
boolean
Indica se il dato è da considerare Extra Contratto.
lat_build
double precision
Coordinata Latitudine.
lng_build
double precision
Coordinata Longitudine.
codice_esterno
varchar(255)
Codice Esterno per allineare altre procedure del cliente.
Parametri:
project_uuid
obbligatorio
UUID del progetto.
active
opzionale
Indica se il dato è in stato attivo.
site_id
opzionale
Ritorna solo i build del padre SITE. Se omesso tutti i BUILD del progetto.

Riposte: ritorna un array di oggetti contenenti le informazioni relative alle categorie di stanze attive per il progetto specificato.

200 OK Esempio di risposta (in JSON):
{ "data": [ { "id": 1, "codice": "ESERCITAZIONE", "descrizione": "ESERCITAZIONE", "indirizzo": "via ESERCITAZIONE", "tel_riferimento": " ", "cell_riferimento": " ", "note": " ", "autore": "root", "revisore": "root", "attivo": true, "disattivato": null, "extra_contratto": false, "codice_esterno": "ESERCITAZIONE" }, { "id": 32,.... } ... ], "empty": false, "total": 32, "source": "builds", "timestamp": "2026-02-17 18:26:23 +0100" }

401 Unauthorized Esempio di risposta negativa (in JSON):
{ "error": "Invalid authentication" }

404 Bad Request Esempio di richiesta errata o parametri errati o assenti (in JSON):
{ "error": "Bad request" }

GET personaldata/build
Descrizione: ritorna registrazione Tabella BUILDS, gruppi di edifici (BUILD)
Parametri:
project_uuid obbligatorio - UUID del progetto
active opzionale - Indica se il dato è in stato attivo
build_id obbligatorio - ID del record richiesto

Riposte: ritorna un record contenente le informazioni relative alle categorie di stanze attive per il progetto specificato.

200 OK Esempio di risposta (in JSON):
{ "data": { "id": 1, "codice": "ESERCITAZIONE", "descrizione": "ESERCITAZIONE", "indirizzo": "via ESERCITAZIONE", "tel_riferimento": " ", "cell_riferimento": " ", "note": " ", "autore": "root", "revisore": "root", "attivo": true, "disattivato": null, "extra_contratto": false, "codice_esterno": "ESERCITAZIONE" }, "empty": false, "total": 1, "source": "build", "timestamp": "2026-02-18 16:36:43 +0100" }

401 Unauthorized Esempio di risposta negativa (in JSON):
{ "error": "Invalid authentication" }

404 Bad Request Esempio di richiesta errata o parametri errati o assenti (in JSON):
{ "error": "Bad request" }

POST personaldata/build_update
Descrizione: aggiorna il record della Tabella BUILDS

I campi definiti: "opzionali" e non verranno modificati se non inviati al server API

Parametri:
project_uuid
obbligatorio
UUID del progetto.
active
opzionale
Indica se il dato è in stato attivo.
site_id
opzionale
Ritorna solo i build del padre SITE. Se omesso tutti i BUILD del progetto.
build_id
obbligatorio
ID del record richiesto.
Informazione su Campi modificabili solo se inseriti
codice:
Codice univoco assegnato dal cliente (non duplicabile).
descrizione:
Descrizione semplice.
site_id:
Relazione con tabella Sites. SITE_ID deve esistere per mantenere la relazione.
indirizzo:
Informazione ad uso funzionale.
note:
Informazione ESTESA ad uso funzionale.
attivo:
Stato del dato, se false dato non utilizzato (come cancellato).
extra_contratto:
Indica se il dato è da considerare Extra Contratto.
lat_build:
Coordinata Latitudine.
lng_build:
Coordinata Longitudine.
codice_esterno:
Codice Esterno per allineare altre procedure del cliente.

200 OK Esempio di risposta (in JSON):
{ "updated": "descrizione: ESERCITAZIONE B2,extra_contratto: true,attivo: true", "source": "build_update", "timestamp": "2026-02-17 16:53:44 +0100" }

401 Unauthorized Esempio di risposta negativa (in JSON):
{ "error": "Invalid authentication" }

404 Bad Request Esempio di richiesta errata o parametri errati o assenti (in JSON):
{ "error": "Bad request" }