Für die korrekte Darstellung und Funktion dieser Website ist JavaScript erforderlich. Bitte aktiviere JavaScript in deinem Browser.

Zum Inhalt springen

Neue Projekte anlegen mit der HERO Lead API

Die HERO Lead API ermöglicht es dir, automatisch neue Projekte mit Kundendaten und Dateien anzulegen, z. B. um ein Kontaktformular auf deiner Website anzubieten oder ein anderes Leadqualifizierungs-Tool vor HERO zu schalten.

Jetzt testen

Authentifizierung

Zuerst benötigst du einen API-Schlüssel von uns. Dieser Service ist für dich kostenlos. Trete dafür bitte mit unserem Support in Kontakt. Der API-Schlüssel muss bei jeder Anfrage als HTTP-Header mitgeliefert werden:

Authorization: Bearer YOUR_API_KEY

Projekt anlegen

Das Anlegen eines neuen Projekts erfolgt via POST-Request zu folgender URL:

POST https://login.hero-software.de/api/v1/Projects/create
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

Die Projektdaten werden dabei als JSON-Objekt im HTTP-Body übermittelt:

{
    "measure": "PRJ",
    "customer": {
        "email": "max.mustermann@example.org",
        "title": "Herr",
        "first_name": "Max",
        "last_name": "Mustermann",
        "company_name": "Meine Firma"
    },
    "address": {
        "street": "Schwarzer Bär 2",
        "city": "Hannover",
        "zipcode": "30449",
        "country_code": "DE"
    },
    "projectaddress": {
        "street": "Schwarzer Bär 5",
        "city": "Hannover",
        "zipcode": "30449",
        "country_code": "DE"
    },
    "project_match": {
        "comment": "Dieser Kommentar erscheint im Logbuch zu dem Projekt.",
        "partner_notes": "Optionale Hinweise für das Notizfeld.",
        "partner_source": "Mein Kontaktformular"
    }
}

Datenmodell

Folgende Datenfelder unterstützen wir bei der Einlieferung:

measure: Kürzel des Gewerks für das Projekt. Die verfügbaren Gewerkskürzel kannst du als Teil der Projektnummer sehen, wenn du dir ein Projekt anlegst. Hier als Beispiel: "PRJ"
customer: Objekt mit Kundendaten. Pflichtfeld ist hier lediglich die Emailadresse.
address: Adresse des Kunden.
projectaddress: Optionale abweichende Objektadresse des Projekts. Falls leer, wird die Kundenadresse genommen.
project_match: Optionale weitere Projektdaten:
- partner_source: Projektquelle, wie z. B. das Kontaktformular auf deiner Website.
- partner_notes: Ergänzende Informationen, die im Notizfeld im Projekt erscheinen.
- comment: Ergänzende Informationen, die im Logbuch erscheinen.

Fehlerbehandlung

Wenn das Projekt erfolgreich angelegt werden konnte, dann gibt der Server einen HTTP-Status von 200 und "status": "success" zurück. In allen anderen Fällen erscheint eine Fehlermeldung im JSON unter message.

PHP-Beispielcode

<?php
$url = 'https://login.hero-software.de/api/v1/Projects/create';
$apikey = 'YOUR_API_KEY'; // den API-Schlüssel bekommst du von unserem Support

$data = array(
    "measure" => "PRJ",
    "customer" => array(
        "email" => "max.mustermann@example.org",
        "title" => "Herr",
        "first_name" => "Max",
        "last_name" => "Mustermann",
        "company_name" => "Meine Firma",
    ),
    "address" => array(
        "street" => "Schwarzer Bär 2",
        "city" => "Hannover",
        "zipcode" => "30449",
        "country_code" => "DE",
    ),
    "projectaddress" => array(
        "street" => "Schwarzer Bär 5",
        "city" => "Hannover",
        "zipcode" => "30449",
        "country_code" => "DE",
    ),
    "project_match" => array(
        "comment" => "Dieser Kommentar erscheint im Logbuch zu dem Projekt.",
        "partner_notes" => "Optionale Hinweise für das Notizfeld.",
        "partner_source" => "Mein Kontaktformular",
    ),
);

$postdata = json_encode($data);

$ch = curl_init($url); 
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); 
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Accept: application/json',
    'Authorization: Bearer '.$apikey,
));
$result = curl_exec($ch);
curl_close($ch);

$response = json_decode($result, true);
if (isset($response['status']) && $response['status'] == 'success') {
    echo "Projekt erfolgreich angelegt";
} else {
    echo "Ein Fehler ist aufgetreten: ".$response['message']."
\n";
    var_dump($response);
}

Noch Fragen?

Du hast noch Fragen zur HERO Lead API? Gern kannst du dich direkt an uns wenden. Hier findest du alle Kontaktmöglichkeiten.