Zum Ändern von Projektdaten über die API folgendes JSON Format an die API senden. Dies kann genutzt werden, um z.B. bereits vorhandene Daten wie Kundenname oder Adresse vor auszufüllen.
Request:
{
"version":1,
"apikey":"xxxxxxxxx", //hier den eigenen API Key einsetzen
"action":"editReportData",
"projektKey":"xxxxxxxx", //der 9-stellige ProjektKey (wurde beim erstellen eines Projektes zurückgegeben)
"projektData":{
"email":"", //E-Mailadresse des Kunden (Heizreport sendet keine Mails eigenständig an den Kunden)
"projektName":"", //Eine eigene interne Projektbezeichnung
"projektPostleitzahl":"33449", //Postleitzahl (aktuell nur deutsche PLZ möglich) int()
"projektArtHeizung":"1", //1= Gasheizung, 2=Ölheizung, 3=Brennwert-Gasheizung, 4=Brennwert-Ölheizung, 5=Pellet, 6=Fernwärme int(1-6)
"projektAlterHeizung":"1", //1=ab 1995, 2=zwischen 1980 bis 1995, 3=vor 1980 int(1-3)
"projektBewohner":"4", //Anzahl Bewohner int(1-8)
"projektJahresverbrauch":"", //in kwh int()
"projektBaujahr":"1985", //int()
"projektTrinkwasser":"1", //1=über Heizungsanlage (mit Zirkulation), 2=über Heizungsanlage (ohne Zirkulation),3=sonstiges System int(1-3)
"projektWaermeerzeugerSolarStatus":"", //on=Solarthermieanlage vorhanden, 'leer'=nicht vorhanden string()
"projektWaermeerzeugerSolarArt":"0", //1=für Warmwasser, 2=für Heizung und Warmwasser int(1-2)
"projektKollektorflaecheSolar":"0", //Kollektorfläche in qm int()
"projektWaermeerzeugerHolzStatus":"", //on=Holzkamin vorhanden, 'leer'=nicht vorhanden string()
"projektJahresverbrauchHolz":"0", //in Raummeter int()
"projektWaermeerzeugerHolzArt":"0", //1=Fichte, 2=Tanne, 3=Kieferm, 4=Birke, 5=Buche, 6=Eiche
"anrede":"0", //0=Frau, 1=Herr
"vorname":"Max",
"name":"Mustermann",
"strasse":"",
"hausnummer":"",
"plz":"",
"ort":"",
"telefon":"",
"bemerkungen":""
}
}
Response:
{
"status":200,
"action":"editReportData",
"projektHeader":{
"key":"xxxxxxxxxx", //Eindeutiger ProjektKey
}
"projektData":{
//hier stehen alle zum Projekt verfügbaren Projektdaten
}
}
Beispielprogrammierung in PHP zum Vorausfüllen eines Projektes
<?
$output = array();
$output["version"] = 1;
$output["apikey"] = "dein api key";
$output["action"] = "editReportData";
$output["projektKey"] = "projekt key";
$output["projektData"]["projektPostleitzahl"] = 33449;
$output["projektData"]["projektBewohner"] = 4;
$output["projektData"]["projektBaujahr"] = 1995;
$output["projektData"]["name"] = 'von " Zons';
$output["projektData"]["vorname"] = "Marcel";
$url = "https://heizreport.de/api/";
$ch = curl_init($url);
# Setup request to send json via POST.
$payload = json_encode($output);
curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );
curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/json'));
# Return response instead of printing.
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );
# Send request.
$result = curl_exec($ch);
curl_close($ch);
# Print response.
print $result;
?>