Fnc26 Api

Auth API
Progetti Fenice

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

Systema

SITES accesso alle informazioni SITI, progetti Fenice

Padre di BUILDS, FLOORS, ROOMS

I siti rappresenta il contenitore di uno o più edifici di una specifica proprietà o progetto. NON è previsto creare nuovi siti con API, perchè al momento la gestione è in capo al sistema Fenice.

GET personaldata/sites

Descrizione: ritorna elenco Tabella siti

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.

indirizzo

varchar(255)

Informazione ad uso funzionale.

tel_riferimento

varchar(255)

Informazione ad uso funzionale.

cell_riferimento

varchar(255)

Informazione ad uso funzionale.

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.

extra_contratto

boolean

Indica se il dato è da considerare Extra Contratto.

codice_esterno

varchar(255)

Codice Esterno per allineare altre procedure del cliente.

Esempio chiamata CURL:


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

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

+ Chiave total indica il numero totale di dati nell'array. Se uguale a 0 non ci sono dati

+ Chiave empty falso si non ci sono dati utili (uguale a "total"="0")

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": "sites", "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/site

Descrizione: ritorna registrazione Tabella SITES, gruppi di edifici (BUILD)

Chiamata CURL:

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

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

                &site_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
site_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": "site", "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/site_update

Descrizione: aggiorna il record della Tabella SITES

Chiamata CURL:


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

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

                &site_id=1

                &descrizione=ESERCITAZIONE%20B2

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

active

opzionale

Indica se il dato è in stato attivo.

site_id

obbligatorio

ID del record richiesto.

Informazione su Campi modificabili solo se inseriti

codice:

Codice univoco assegnato dal cliente (non duplicabile).

descrizione:

Descrizione semplice.

indirizzo:

Informazione ad uso funzionale.

tel_riferimento:

Informazione ad uso funzionale.

cell_riferimento:

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.

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