ROOM STDs

Fenice Api

Auth API
Progetti Fenice

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

Systema

ROOM STDS accesso alle informazioni ROOM Standard, progetti Fenice

Lo standard definisce la specializzazione d`uso di una stanza (ASCENSORE, ATRIO, BAGNO PRIVATO)

Le ROOM Standard dipendo dalle Categorie ROOM, tramite la chiave roomcat_id

GET personaldata/room_stds

Descrizione: ritorna elenco Tabella ROOM_STDS Fenice

Dati:

id

integer

Codice auto incrementale univoco fornito dal sistema.

codice

varchar

Codice univoco assegnato dal cliente (non duplicabile).

descrizione

varchar

Descrizione semplice.

extra_contratto

boolean

Flag di gestione contratto extra, non preventivato.

css_color

varchar

Colore CSS che rappresenta la RoomCat.

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

                ?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
roomcat_id facoltativo - ID della cateria (ommesso ritorna tutte le voci della tabella)
active default true - impostata a false ritorna anche le installazioni disattivate (opzionale)

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": [ { "data": [ { "id": 2, "codice": "CHIUSO", "descrizione": "CHIUSO", "roomcat_id": 4, "css_color": "FFFFFF", "attivo": true, "extra_contratto": false, "autore": "root", "revisore": null, "disattivato": null }, { "id": 3, "codice": "NON ACESSIBILE", "descrizione": "NON ACESSIBILE DA TUTTI I LATI", "roomcat_id": 4,......, }, .... ], "empty": false, "total": 2, "source": "roomstds", "timestamp": "2026-02-17 17:55:33 +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_std

Descrizione: ritorna registrazione Tabella ROOM_STDS Fenice

Chiamata CURL:

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

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

                &room_std_id=1

                &attivo=true'

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

Parametri:
project_uuid obbligatorio - uuid del progetto
roomstd_id obbligatorio - id della registrazione
active facoltativo - impostazione predefinita "true" - impostata a false ritorna anche le installazioni disattivate (opzionale)

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": "RAIL REGOLATO", "descrizione": "RAIL REGOLATO", "css_color": "FFFFFF", "attivo": true, "extra_contratto": falsee, "autore": "root", "revisore": "root", "disattivato": null }, "empty": false, "total": 1, "source": "roomstds", "timestamp": "2026-02-17 10:28:20 +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_std_update

Descrizione: aggiorna il record della Tabella ROOM_STDS Fenice

Chiamata CURL:


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

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

                &roomstd_id=1

                &descrizione=RAIL%20REGOLATO

                &extra_contratto=true

                &attivo=true'

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

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

Parametri:
project_uuid obbligatorio - uuid del progetto
room_std_id obbligatorio - id dello Standard

Informazione su Campi modificabili solo se inseriti
codice facoltativo - codice univoco della stanza
descrizione facoltativo - descrizione della stanza
css_color facoltativo - colore della stanza
extra_contratto facoltativo - impostazione predefinita "false" - impostata a true indica che la stanza è un extra contratto
attivo facoltativo - impostazione predefinita "true" - impostata a false disattiva la stanza

Riposte:

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