API/ContrattiDiFornitura

From Smart Biogas Wiki
Jump to navigation Jump to search

◀ Torna al menù API

Elenco dei contratti di fornitura

Nell'header delle richieste va specificata l'autenticazione

X-API-TOKEN: {chiave da 128 caratteri fornita per l'impianto in questione)


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

Risultato: Json dei contratti di fornitura dell'impianto

[
	{
		"plant_suppliers_contracts_id": idContrattoDiFornitura,
		"f_contract_number": "Numero o codice del contratto",
		"f_certificate_number": "Numero o codice del certificato",
		"f_date_start": "Data in formato ISO di partenza del contratto",
		"f_date_end": "Data in formato ISO di chiusura del contratto",
		"soggetto_id": idSoggetto del fornitore
	},
	{
		"plant_suppliers_contracts_id": 47,
		"f_contract_number": "",
		"f_certificate_number": "",
		"f_date_start": "2025-05-12",
		"f_date_end": "2026-05-12",
		"soggetto_id": 1876
	},
	...
]

Ricerca filtrando un fornitore

GET https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id={idSoggetto}

esempio https://smartbiogas.it/api/v1/suppliercontracts?soggetto_id=1875

Risultato: stesso Json ma con 0 o più contratti filtrati per il fornitore passato nei criteri


Dati del contratto

GET https://smartbiogas.it/api/v1/suppliercontracts/{idContrattoDiFornitura}

esempio https://smartbiogas.it/api/v1/suppliercontracts/47

Risultato: stesso Json di sopra ma con un solo record e dettagli maggiori

{
	"plant_suppliers_contracts_id": 47,
	"f_contract_number": "",
	"f_certificate_number": "",
	"f_date_start": "2025-05-12",
	"f_date_end": "2026-05-12",
	"soggetto_id": 1876,
	"feedstocks": [
		{
			"substrati_id": idProdotto,
			"f_substrati_description": "Descrizione multilingua del prodotto",
			"f_substrati_qta": quantità stipulata nel contratto in tons/anno
			"f_contract_price": prezzo del contratto in €/anno
		},
		{
			"substrati_id": 6,
			"f_substrati_description": "{\"it\":\"Mais pianta intera insilato\",\"en\":\"Maize whole plant silage\",\"es\":\"Maize whole plant silage\",\"fr\":\"Maïs plante entière ensilée\"}",
			"f_substrati_qta": 2500,
			"f_contract_price": 1000,
		},
	],
	...
}