Fnc26 Api

Fenice Api

Auth API
Progetti Fenice

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

Systema

ROOMS accesso alle informazioni stanze, progetti Fenice

GET personaldata/rooms

Descrizione: ritorna elenco Tabella Stanze

Dati della tabella:

id

integer

Codice auto incrementale univoco fornito dal sistema.

codice

varchar(255)

Codice univoco assegnato dal cliente (non duplicabile).

descrizione

varchar(255)

Descrizione semplice.

roomcat_id

integer

Relazione con tabella ROOMCATS. ROOMCAT_ID deve esistere per mantenere la relazione.

roomstd_id

integer

(NON USATO) Relazione con tabella ROOMSTDS. ROOMSTD_ID deve esistere per mantenere la relazione.

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.

floor_id

integer

Relazione con tabella FLOORS. FLOOR_ID deve esistere per mantenere la relazione.

svg_x

double precision

Coordinata X del punto centrale del SVG.

svg_y

double precision

Coordinata Y del punto centrale del SVG.

svg

text

Codice SVG, che rappresenta la grafica della Room.

svg_class

varchar(255)

Indica la classe SVG da applicare al Room.

svg_param

text

Parametri SVG da applicare al Room.

svg_area

double precision

Area della Room in m2.

stato

varchar(255)

Stato della Room (IN_PRODUCTION,TO_DO, DONE, SUSPENDED, NR, DEACTIVATE).

ehandle

varchar(255)

Codice CAD-EHANDLE del Room.

dwg_layer

varchar(255)

Riferimento al Layer, utile per i SIMBOLI nel CAD Fenice.

extra_contratto

boolean

Indica se il dato è da considerare Extra Contratto.

codice_esterno

varchar(255)

Codice Esterno per allineare altre procedure del cliente.

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.

updated_at

timestamp

Data e ora dell'ultima modifica del record.

Esempio chiamata CURL:

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

                ?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.

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": 10, "codice": "10", "descrizione": "LC001", "roomcat_id": null, "floor_id": 3, "autore": "root", "revisore": "alex", "attivo": true, "disattivato": null, "updated_at": "2024-11-26T22:33:33.903Z", "roomstd_id": null, "svg_x": 0.0, "svg_y": 0.0, "svg": "1.333426,102.614619 32.002232,102.614619 32.002232,2.565366 1.333426,2.565366 1.333426,102.614619", "site_id": 1, "build_id": 1, "svg_class": "room", "svg_param": "onclick=\"textroom(id)\" onmousemove=\"showroom_svg(evt,id)\" onmouseout=\"emptyroom(id)\"", "svg_area": 3068.391093, "stato": "IN_PRODUCTION", "ehandle": "", "dwg_layer": "RM$", "extra_contratto": false, "codice_esterno": "ESERCITAZIONE_LEGENDA_P02_LC001" }, { "id": 100, "codice": "100", "descrizione": "LC043", "roomcat_id": null, "floor_id": 13, "autore": "root", "revisore": "6", "attivo": true, "disattivato": null, "updated_at": "2024-07-28T09:28:29.108Z", "roomstd_id": null, "svg_x": 0.0, "svg_y": 0.0, "svg": "6.3286,7.8509 7.3886,7.8454 7.3823,6.6354 6.3223,6.6409 6.3286,7.8509", "site_id": 3, "build_id": 8, "svg_class": "room", "svg_param": "onclick=\"textroom(id)\" onmousemove=\"showroom_svg(evt,id)\" onmouseout=\"emptyroom(id)\"", "svg_area": 1.282635, "stato": "DONE", "ehandle": "", "dwg_layer": "RM$", "extra_contratto": false, "codice_esterno": "LO1285_FV01_PF00_LC043" } ], "empty": false, "total": 2, "source": "rooms", "timestamp": "2026-02-24 09:06:08 +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/room

Descrizione: ritorna registrazione Tabella ROOM

Chiamata CURL:

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

                ?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.

room_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": 10, "codice": "10", "descrizione": "LC001", "roomcat_id": null, "floor_id": 3, "autore": "root", "revisore": "alex", "attivo": true, "disattivato": null, "updated_at": "2024-11-26T22:33:33.903Z", "roomstd_id": null, "svg_x": 0.0, "svg_y": 0.0, "svg": "1.333426,102.614619 32.002232,102.614619 32.002232,2.565366 1.333426,2.565366 1.333426,102.614619", "site_id": 1, "build_id": 1, "svg_class": "room", "svg_param": "onclick=\"textroom(id)\" onmousemove=\"showroom_svg(evt,id)\" onmouseout=\"emptyroom(id)\"", "svg_area": 3068.391093, "stato": "IN_PRODUCTION", "ehandle": "", "dwg_layer": "RM$", "extra_contratto": false, "codice_esterno": "ESERCITAZIONE_LEGENDA_P02_LC001" }, "empty": false, "total": 1, "source": "roomcats", "timestamp": "2026-02-24 09:47:34 +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/room_update

Descrizione: aggiorna il record della Tabella ROOMS

Chiamata CURL:


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

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

                &room_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.

room_id

obbligatorio

ID del record richiesto.

site_id

opzionale

Modifica l'associazione con il SITE. Attenzione alla coerenza Site/Build/Floor!.

build_id

opzionale

Modifica l'associazione con il BUILD. Attenzione alla coerenza!.

floor_id

opzionale

Modifica l'associazione con il FLOOR. Attenzione alla coerenza!.

Informazione su Campi modificabili solo se inseriti

codice:

Codice univoco assegnato dal cliente (non duplicabile).

descrizione:

Descrizione semplice.

roomcat_id:

Relazione con tabella ROOMCATS. ROOMCAT_ID deve esistere per mantenere la relazione.

roomstd_id:

(NON USATO) Relazione con tabella ROOMSTDS. ROOMSTD_ID deve esistere per mantenere la relazione.

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.

floor_id:

Relazione con tabella FLOORS. FLOOR_ID deve esistere per mantenere la relazione.

svg_x:

Coordinata X del punto centrale del SVG.

svg_y:

Coordinata Y del punto centrale del SVG.

svg:

Codice SVG, che rappresenta la grafica della Room.

svg_area:

Area della Room in m2.

stato:

Stato della Room (IN_PRODUCTION,TO_DO, DONE, SUSPENDED, NR, DEACTIVATE).

ehandle:

Codice CAD-EHANDLE del Room.

dwg_layer:

Riferimento al Layer, utile per i SIMBOLI nel CAD Fenice.

extra_contratto:

Indica se il dato è da considerare Extra Contratto.

codice_esterno:

Codice Esterno per allineare altre procedure del cliente.

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/room_new

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

Chiamata CURL:


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

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

                &floor_id=1

                &codice=R101

                --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.

floor_id

obbligatorio

Associa al FLOOR, per mantenere la coerenza Site/Build/Fllor!.

codice

obbligatorio

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

'R101'

descrizione

opzionale

Assegna una descrizione alla stanza.

'UFFICIO'

200 OK Esempio di risposta (in JSON):
{ "room_id": 1, "timestamp": "2026-02-17 16:53:44 +0100" "created": "creazione della Room con codice R101 associata al FLOOR 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" }