API/Analisi

From Smart Biogas Wiki
Jump to navigation Jump to search

◀ Torna al menù API

Elenco delle analisi dell'impianto in oggetto

GET https://smartbiogas.it/api/v1/analysis

Risultato: Json con un array di risultati

[
	{
		"analisys_id": idAnalisi,
		"f_data": "Data in formato ISO YYYY-MM-DD",
		"analisys_type_id": idTipoAnalisi,
		"soggetto_id": idLaboratorio (da API/Soggetti),
		"substrati_id": idSubstrati,
		"f_cod": "Codice del tipo di analisi"
	},
	{
		"analisys_id": 2379,
		"f_data": "2017-08-10",
		"analisys_type_id": 6,
		"soggetto_id": -1,
		"substrati_id": -1,
		"f_cod": "GA-BAS"
	},
	...
]


Dati della singola analisi:

GET https://smartbiogas.it/api/v1/analysis/{idAnalisi}

esempio https://smartbiogas.it/api/v1/analysis/1136

Risultato: stesso Json di sopra ma con un solo record e maggiori dettagli. E' presente inoltre una voce chiamata parametri che contiene un array di determinands.

{
	"analisys_id": 1136,
	"f_data": "2013-11-25",
	"analisys_type_id": 7,
	"soggetto_id": -1,
	"substrati_id": -1,
	"ID": 7,
	"F_Descrizione": "Fumi - analisi rispetto D.Lgs. 152\/2006",
	"ID_Checklist": 145,
	"substrati_analisi_id": 7,
	"set_analisi_id": 1,
	"f_cod": "FU-BAS",
	"f_substrati_cod": "FU",
	"f_substrati_description": "Fumi CHP",
	"f_set_cod": "BAS",
	"f_set_description": "Analisi di base",
	"parametri": [
		{
			"analysis_parameter_id": idParametroAnalisi,
			"determinand_id": INT idDeterminand,
			"determinand_cod": TEXT "codice determinand",
			"determinand_description": "descrizione determinand",
			"sample_type_id": idTipoCampione,
			"sample_type_cod": "codice tipo campione",
			"sample_type_description": "descrizione tipo campione",
			"f_metodo": "testo riportante i metodi utilizzati delle analisi",
			"f_value": DECIMALE valore dell'analisi,
			"unita_misura_id": idUnitàMisura,
			"f_um": "descrizione unità di misura",
			"f_note": "eventuali note da riportare sulla lettura"
		}
		{
			"analysis_parameter_id": 7,
			"determinand_id": 5,
			"determinand_cod": "NOx_NO2",
			"determinand_description": "Ossidi di azoto",
			"sample_type_id": 2,
			"sample_type_cod": "tq",
			"sample_type_description": "sul tal quale",
			"f_metodo": "Norme UNI EN 14789:2017 – UNI EN 14792:2017 – UNI EN 15058:2017",
			"unita_misura_id": 38,
			"f_value": "481.0000",
			"f_um": "mg\/Nmc",
			"f_note": "test da cancellare"
		},
		...
	]
}

Inserimento di un'analisi

[edit | edit source]

E' possibile inviare un'analisi fornendo con la seguente API un Json contenente tutti i dati.

POST http://smartbiogas.it/api/v1/analysis

Nel post va usato questo formato, oltre alla chiave X-API-TOKEN per identificare l'impianto.

Nel campo f_document inserire solo un documento PDF (codificato in BASE64).

{
	"f_data": DATA in formato ISO,
	"analysis_type_id": idTipoAnalisi,
	"soggetto_id": idSoggetto (del laboratorio che fa l'analisi. Lasciare -1 se non specificato),
	"substrati_id": idSubstrato (solo se l'analisi è fatta su un materiale particolare, altrimenti lasciare -1),
	"f_code": TEXT codice/numero del documento,
	"f_document": TEXT File del documento codificato in BASE64
	"parametri" :[
		{
			"analysis_parameter_id": idParametroAnalisi,
			"lca_unita_misura_id": isUnitàMisura,
			"f_value" : DECIMAL valore della misura nell'unità di misura specificata
			
		},
		...
		
	]
}

Esempio:

{
	"f_data": "2026-01-31",
	"analysis_type_id": 7,
	"soggetto_id": -1,
	"substrati_id": -1,
	"f_code":"38572.024",
	"f_document":"JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVyIC9GbGF0ZURlY29kZT4...."
	"parametri" :[
		{
			"analysis_parameter_id": 7,
			"lca_unita_misura_id": 38,
			"f_value" : 0.23
			
		}
		{
			"analysis_parameter_id": 7,
			"lca_unita_misura_id": 38,
			"f_value" : 4.82
			
		}
		
	]
}