Fenice Api

Benvenuto in FENICE servizio API.

Le credenziali, sono configurate a livello di sistema Fenice e rilasciate dal personale incaricato del server.

L'accesso è controllato e verificato, dalla sociatà TiClean S.R.L.s di Roma

Nel menù di sinistra puoi trovare la documentazione alle funzionalità disponibili.

FENICE-API offre un servizio API per la fruizione delle planimetrie. Le planimetrie sono disponibili per chi richiede il servizio di FENICE Censimento/Surverings.

Perchè FENICE?

Il processo "FENICE" è un sistema di gestione dei dati geografici indoor e Outdoor che consente di convertire file DXF, CAD o PDF in file SVG.

Questo consente di visualizzare i dati in un formato più inter-operabile tramite il WEB senza plug-in.

Il Servizio FENICE è generalmente usato per la rilevazione dei dati indoor e outdoor, per confermare al gestore dell'immobiliare che i dati sono reali, certificati, revisionati e utilizzabili per diverse attività in qualsiasi momento e in qualsiasi luogo.

La conversione delle informazioni ha uno specifico metodo per determinare superfici, varchi, porte e finestre. Le entità così definite sono rappresentate per capire dove e come sono stati posizionati e come interagire con gli utenti, incaricati di gestire i dati e asset.

Vantaggi di FENICE-API?

Le planimetrie sono realizzate convertendo file DXF, CAD o ricalcando PDF in file SVG. Questo consente di visualizzare i dati in un formato più inter-operabile tramite il WEB senza plug-in.

La diffusione del WEB consente di visualizzare i dati praticamente ovunque e interagire se necessario. Consente di ottenere dati reali, certificati, revisionati e utilizzabili per diverse attività in qualsiasi momento e in qualsiasi luogo.

Il suo valore sta nella possibilità di essere aggiornata e mantenuta in tempo reale, da strumenti di analisi e di visualizzazione dei dati. Più professionisti possono operare in modi diversi su una unica base dati.

Gli asset presenti in una planimetria sono rappresentati per capire dove e come sono stati posizionati e come interagire con gli utenti, incaricati di gestire i dati e asset.

Il valore della planimetria diventa del proprietario degli immobili e della sua gestione. I servizi possono essere erogati a chi svolge servizi di supervisione e controllo dell'immobiliare e non dipendere da esso

Le planimetrie possono essere certificate da personale qualificato e supervisionato da un ente di controllo.

Alcune definizioni di campi utili per la gestione delle planimetrie

Le API sono sviluppate in linguaggio RUBY e segue alcune regole di progettazione. I parametri di input e output sono rappresentati in JSON.

• null (JSON): è il termine standard previsto dalla specifica JSON per rappresentare un valore nullo. Non va racchiuso tra virgolette (altrimenti diventerebbe la stringa "null").

• nil (nei linguaggi di programmazione): Linguaggi come Go, Ruby o Swift usano il concetto di nil (o None in Python) nei loro modelli dati interni. Durante la serializzazione (marshalling) in JSON, un puntatore o un oggetto nil viene solitamente convertito nel valore JSON null.

Combinazioni possibili per impostare il campo a "null"

  • "key": nil - nel DB è memorizzato NULL
  • "key": "" - nel DB è memorizzato NULL
  • "key": "nil" - nel DB è memorizzato NULL
  • "key": "null" - nel DB è memorizzato NULL
  • "key": "NULL" - nel DB è memorizzato NULL

Combinazioni possibili per un campo "Booleano"

  • "key": true - nel DB è memorizzato TRUE
  • "key": "true" - nel DB è memorizzato TRUE
  • "key": false - nel DB è memorizzato FALSE
  • "key": "false" - nel DB è memorizzato FALSE

Campi riserva al sistema API

I sistema API, gestisce in autonomia i campi delle tabelle "autori", "revisori" e "disattivato" in conformità delle specifiche Fenice. All`interno verrà scritto in questa modalità:

  • api_v0 è la versione di API utilizzata;
  • nome_dva il nome del dispositivo connesso con Token, debfinta nella tabella DEV_API, gestita da base Fenice
  • nome_utente il nome della login effettuata (omessa se è solo dispositivo senza operatore)

Versionamento del sistema API

Al momento esiste il progetto Fenice V.0, che è la versione di API utilizzata. Questa versione è la prima versione di API utilizzata. La sua compatibilità è attualmente basata sul progetto FENICE e serve ad interagire con lei.

Le versioni future saranno dei potenziamenti e aggiungeranno nuove funzionalità.

In futuro lo stesso Fenice verrà aggiornato da procedure più aggiornate e funzionali, in un nuovo concetto di processo / fruibilità.

Elenco codici messaggi che una API può produrre in risposta:

Codice Descrizione
200 Operazione eseguita con successo
401 Errore su operazione non da segnalare
402 Operazione non autorizzata
403 Operazione non autorizzata
404 Operazione non trovata
429 Troppe richieste in coda
500 Errore interno del server