Fenice Api
Accesso alla informazioni di edifici/BUILDS.
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.

Informazioni su attributi o parametri:
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.
GET /personaldata/builds
Restituisce l'elenco degli Edifici associati ad un progetto specifico individuato da `project_uuid`, fornendo 'site_id' ritorna solo i BUILD del padre SITE. Se omesso tutti i BUILD del progetto.

Parameters

Parametri:
Richiesti:
Descrizione dei parametri:
Esempio:
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.

Responses

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,
      "others": "...."
    }
  ],
  "empty": false,
  "total": 32,
  "source": "sites",
  "timestamp": "2026-02-17 18:26:23 +0100"
}
401 Unauthorized
Esempio di risposta (in JSON):
{
  "error": "Unauthorized"
}
404 Bad Request
Esempio di risposta (in JSON):
{
  "error": "Bad request"
}
GET /personaldata/build
Restituisce un singolo record di un Edificio specifico individuato da `build_id` e `project_uuid`.

Parameters

Parametri:
Richiesti:
Descrizione dei parametri:
Esempio:
project_uuid
obbligatorio
UUID del progetto.
active
opzionale
Indica se il dato è in stato attivo.
build_id
obbligatorio
ID del record richiesto.

Responses

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 (in JSON):
{
  "error": "Unauthorized"
}
404 Bad Request
Esempio di risposta (in JSON):
{
  "error": "Bad request"
}
POST /personaldata/build_update
Aggiorna le informazioni di un sito specifico individuato da `site_id` e `project_uuid`.

Parameters

Parametri:
Richiesti:
Descrizione dei parametri:
Esempio:
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 i Campi modificabili
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.

I campi sono opzionali e non verranno modificati se non indicati

Responses

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