Fnc26 Api

Fenice Api

Auth API
Progetti Fenice

Anagrafiche
- Sites
- Builds
- Floors
  - SVG
- Rooms
  - SVG
Censimento

Systema

FLOORS accesso alle informazioni dei piani

Padre di ROOMS

GET personaldata/floors

Descrizione: ritorna elenco Tabella Piani

Dati della tabella:

id

integer

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.

build_id

integer

Relazione con tabella BUILDS. BUILD_ID deve esistere per mantenere la relazione.

dwg_cliente

varchar(255)

Informazione ad uso funzionale.

dwg_fenice

varchar(255)

Informazione ad uso funzionale.

altezza

varchar(255)

Informazione ad uso funzionale.

ordine

integer

Ordine di visualizzazione come una pulsantiera di ascensore.

edificio_principale

varchar(255)

Informazione ad uso funzionale.

quota

varchar(255)

Informazione ad uso funzionale. Indica la quota rispetto al piano stradale.

piano_ferro

varchar(255)

Informazione ad uso funzionale. In alcune dinamiche il piano ferro (ove transitano altri veicoli) può essere diverso dal piano stradale.

extra_contratto

boolean

Indica se il dato è da considerare Extra Contratto.

codice_esterno

varchar(255)

Codice Esterno per allineare altre procedure del cliente.

note

text

Informazione ESTESA ad uso funzionale.

autore

varchar(255)

Utente che ha registrato il record.

revisore

varchar(255)

Ultimo utente che ha aggiornato il record.

attivo

boolean

Stato del dato, se false dato non utilizzato (come cancellato).

disattivato

varchar(255)

Utente che ha disattivato il dato.

created_at

timestamp

Data e ora di creazione del record.

updated_at

timestamp

Data e ora dell'ultima modifica del record.

Esempio chiamata CURL:

curl --location 'https://fnc26api.fenice.software/api/v0/personaldata/floors

                ?project_uuid=6062887d-1f94-4ada-b5c2-************

                &attivo=true'

                --header 'Authorization: Bearer ••••••[qui inserire Token JWT ottenuto da POST
                authapi/authorize_api]'

Parametri:

project_uuid

obbligatorio

UUID del progetto.

active

opzionale

Indica se il dato è in stato attivo.

build_id

opzionale

Ritorna solo i floor del padre BUILD. Se omesso tutti i FLOOR 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": "floors", "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/floor

Descrizione: ritorna registrazione Tabella FLOORS, piani di un edificio

Chiamata CURL:

curl --location 'https://fnc26api.fenice.software/api/v0/personaldata/floor

                ?project_uuid=6062887d-1f94-4ada-b5c2-************

                &floor_id=1

                &attivo=true'

                --header 'Authorization: Bearer ••••••[qui inserire Token JWT ottenuto da POST
                authapi/authorize_api]'

Parametri:

project_uuid

obbligatorio

UUID del progetto.

active

opzionale

Indica se il dato è in stato attivo.

floor_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": "floor", "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/floor_update

Descrizione: aggiorna il record della Tabella FLOORS

Chiamata CURL:


                curl --location --request POST POST 'https://fnc26api.fenice.software/api/v0
                /personaldata/floor_update

                ?project_uuid=89a28010-e6ff-43fa-bccf-************

                &floor_id=1

                &descrizione=ESERCITAZIONE%20B2

                &extra_contratto=true

                &attivo=true' \

                --header 'Authorization: Bearer ••••••[qui inserire Token JWT ottenuto da POST
                authapi/authorize_api]'

Parametri:

project_uuid

obbligatorio

UUID del progetto.

active

opzionale

Indica se il dato è in stato attivo.

site_id

obbligatorio

Associa il floor del padre SITE.

build_id

obbligatorio

Associa il floor al padre BUILD.

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.

build_id:

Relazione con tabella BUILDS. BUILD_ID deve esistere per mantenere la relazione.

dwg_cliente:

Informazione ad uso funzionale.

dwg_fenice:

Informazione ad uso funzionale.

altezza:

Informazione ad uso funzionale.

ordine:

Ordine di visualizzazione come una pulsantiera di ascensore.

edificio_principale:

Informazione ad uso funzionale.

quota:

Informazione ad uso funzionale. Indica la quota rispetto al piano stradale.

piano_ferro:

Informazione ad uso funzionale. In alcune dinamiche il piano ferro (ove transitano altri veicoli) può essere diverso dal piano stradale.

extra_contratto:

Indica se il dato è da considerare Extra Contratto.

codice_esterno:

Codice Esterno per allineare altre procedure del cliente.

note:

Informazione ESTESA ad uso funzionale.

attivo:

Stato del dato, se false dato non utilizzato (come cancellato).

200 OK Esempio di risposta (in JSON):
{ "updated": "descrizione: ESERCITAZIONE B2,extra_contratto: true,attivo: true", "source": "floor_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" }

POST personaldata/floor_new

Descrizione: crea un nuovo record nella Tabella FLOORS e ritorna il suo ID

Chiamata CURL:


                curl --location --request POST POST 'https://fnc26api.fenice.software/api/v0
                /personaldata/floor_new

                ?project_uuid=89a28010-e6ff-43fa-bccf-************ 

                &build_id=1

                $codice=Piano123

                --header 'Authorization: Bearer ••••••[qui inserire Token JWT ottenuto da POST
                authapi/authorize_api]'

Parametri:

Richiesti:

Descrizione dei parametri:

Esempio:

project_uuid

obbligatorio

UUID del progetto.

build_id

obbligatorio

Ritorna solo i floor del padre BUILD. Se omesso tutti i FLOOR del progetto.

codice

obbligatorio

Assegna un codice alla stanza. Questo codice è poi diverso da quello rilevato da censore in populate.

'P01'

descrizione

opzionale

Assegna una descrizione al piano.

'PIANO TERRA'

200 OK Esempio di risposta (in JSON):
{ "floor_id": 1, "timestamp": "2026-02-17 16:53:44 +0100" "created": "creazione della Piano o livello con Piano123 associata al BUILD_ID:1", }

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" }