Einführung

Hier finden Sie alles was zur Einrichtung und Verbindung des SDK mit der ImmobilienScout24 API nötig ist. Beachten Sie bitten, dass für manche Aktionen spezielle Berechtigungen nötig sind. Infos dazu finden Sie hier.

Mit API verbinden

Um die Funktionen nutzen zu können die über das Immocaster SDK zur Verfügung stehen, muss man sich über das SDK mit der ImmobilienScout24 API verbinden. Hierfür benötigen Sie als Zugangsdaten den oAuth-Key und oAuth-Secret, welche kostenlos auf der Developer-Website von ImmobilienScout24 angefordert werden können. 
Für die Verbindung zur ImmobilienScout24 API über das SDK ist ein einfaches Script nötig, welches die Verbindung startet. Das SDK muss zuerst geladen und dann lediglich KEY und SECRET als Parameter in die Instanz ($oImmocaster) übergeben werden. Als erster Parameter wird der Namespace für das Objekt übergeben.

<?php
    
// SDK laden
require_once('Immocaster/Sdk.php');

// Verbinden
$sImmobilienScout24Key = 'KEY';
$sImmobilienScout24Secret = 'SECRET';
$oImmocaster = Immocaster_Sdk::getInstance('is24',$sImmobilienScout24Key,$sImmobilienScout24Secret);

?>

Natürlich muss "Immocaster/Sdk.php" der richtige Pfad zur Datei "Sdk.php" sein. Nach erfolgreicher Verbindung kann man nun mit weiteren Anfragen an die API starten. Es muss darauf geachtet werden, welchen Key man angefordert hat. Standardmäßig versucht sich das Immocaster SDK mit der Sandbox zu verbinden. Sollten Key und Secret für den Live-Bestand von ImmobilienScout24 sein, muss man in den Live-Modus umschalten. Außerdem wir empfohlen mit cURL zu arbeiten, da es sonst teilweise zu Problemen auf manchen Servern kommen kann.

Mit Live-Daten arbeiten

Standardmäßig nutzt Immocaster die Sandbox von ImmobilienScout24, welche Testobjekte zur Verfügung stellt. Um mit echten Daten arbeiten zu können, benötigen Sie die Berechtigung für Ihren Key und Secret von ImmobilienScout24. Sofern die Berechtigung für die Arbeit mit Live-Daten besteht, muss folgender Code ergänzt werden um vom Sandbox-Modus in den Live-Modus zu wechseln:

<?php

$oImmocaster->setRequestUrl('live');

?>

Mit diesem Code wird die Hauptdomain für Requests von der Sandbox-Domain (sandbox.immobilienscout24.de) auf die Live-Domain (rest.immobilienscout24.de) geändert. Es besteht ebenfalls die Möglichkeit zur Laufzeit des Scripts wieder von Live-Modus auf Sandbox-Modus zu schalten. Dazu muss einfach folgender Code ausgeführt werden:

<?php

$oImmocaster->setRequestUrl('sandbox');

?>

Der komplette Code zum Verbinden mit der Live API von ImmobilienScout24 sieht demnach folgendermaßen aus:

<?php

// SDK laden
require_once('Immocaster/Sdk.php');

// Verbinden
$sImmobilienScout24Key = 'KEY';
$sImmobilienScout24Secret = 'SECRET';
$oImmocaster = Immocaster_Sdk::getInstance('is24',$sImmobilienScout24Key,$sImmobilienScout24Secret);

// Mit Live-API arbeiten
$oImmocaster->setRequestUrl('live');

?>