Ändern von Projektdaten / Vorausfüllen eines Projektes

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