Integration

SDK

Das Software Development Kit (SDK) bietet eine Sammlung an Services zur nahtlosen Integration unserer Konfiguratoren via API in eigene Projekte und Anwendungen. Nachstehend finden Sie die grundlegenden Schritte zur Einrichtung.

Nutzen Sie unser Anwendungsbeispiel für einen schnellen Einstieg. Dieses finden Sie hier zum Download.

Grundlagen

Starten Sie mit der Definition der grundlegenden Variablen. Ihre Client ID finden Sie in den Einstellungen unter API innerhalb der Rubrik Integrationen. Bei User und Password tragen Sie einfach Ihre regulären Anmeldeinformationen ein.

Beispiel: index.php


header('Content-Type: text/html; charset=utf-8');

session_start();$_COOKIE['PHPSESSID']=session_id();$session=$_COOKIE['PHPSESSID'];



$client='00000';

$user='benutzer@email.de';

$password='passwort';

$language='DE';

$language_extension='_german';

$protocol='https';

$host='server.fenzon.de';

Anschließend kann die Funktion zum Aufruf der API erstellt werden.

Beispiel: index.php


function CallAPI($method,$url,$data=false){

global $client,$user,$password,$session,$language;

$authorization=base64_encode(sprintf('%s:%s',$user,$password));

$curl=curl_init();

switch($method){case "POST":curl_setopt($curl,CURLOPT_POST,1);if($data)curl_setopt($curl,CURLOPT_POSTFIELDS,$data);break;case"PUT":curl_setopt($curl,CURLOPT_PUT, 1);break;default:if($data)$url=sprintf("%s&%s",$url,http_build_query($data));}

curl_setopt($curl,CURLOPT_URL,$url);curl_setopt($curl,CURLOPT_RETURNTRANSFER,1);

$headers=array('Authorization: Basic '.$authorization,'Client: '.$client,'Session: '.$session,'Language: '.$language);

curl_setopt($curl,CURLOPT_HTTPHEADER,$headers);

$result=curl_exec($curl);

curl_close($curl);

return $result;

}

Produktkonfigurator

Der Produktkonfigurator kann über den folgenden Befehl aufgerufen werden.

Beispiel: index.php


$data['type']='door';

echo json_decode(CallAPI('GET',$host.'/api.php?v=1&ep=svcConfigurator',$data));

Der nachstehende Code, wird bei jeder Änderung aufgerufen und aktualisiert den Produktkonfigurator.

Beispiel: index.php


if(isset($_POST['configurator']) AND !isset($_POST['action'])){

	$settings=json_decode(CallAPI('GET',$host.'/api.php?v=1&ep=svcConfiguratorSettings',$_POST),true);

	echo json_encode($settings);exit();

}

Dieser Abschnitt liefert eine Produktabbildung, Preisinformationen, eine Produktbeschreibung und die Konfigurationsdaten zurück, die direkt an einen Warenkorb oder in eine Datenbank übertragen werden können. Ist eine Konfiguration nicht baubar, wird stattdessen eine Restriktionsmeldung zurückgegeben.

Beispiel: index.php


if(isset($_POST['action']) AND $_POST['action']=='configSave'){

	$save=json_decode(CallAPI('GET',$host.'/api.php?v=1&ep=svcConfiguratorSave',$_POST),true);

	echo json_encode($save);exit();

}