Objekte

Hier erfahren Sie, wie Sie erweiterte Zusatzinformationen über ein Objekt abfragen.

Wichtig: Diese Möglichkeit wird standardmäßig von ImmobilienScout24 deaktiviert. Sollte es Fragen zur Berechtigung mit Key/Secret geben, wenden Sie sich bitte direkt an ImmobilienScout24.

Objekt aufrufen

Für das auslesen eines kompletten Datensatz für ein Objekt benötigt man die ID des Objekts. Diese ID erhält man z.B. über die "Suche nach Radius" oder die "Suche nach ID (GeoCode)". Anschließend kann folgende Funktion mit dieser ID aufgerufen werden:

<?php

$aParameter = array('exposeid'=>12345678);
$res = $oImmocaster->getExpose($aParameter);

?>

Wichtig: Über die oben genannte Methode erhält man nur Objekte, die in der Administration von IS24 mit "Für Homepage veröffentlichen" markiert wurden. Möchte man z.B. auf eigene Objekte zugreifen, auch wenn diese nicht veröffentlicht sind, muss man zuerst die Applikation zertifizieren. Anschließend kann man folgenden Code ausführen:

<?php

$aParameter = array('username' => 'me','exposeid' => '12345678');
print_r($oImmocaster->getUserExpose($aParameter));

?>

Rückgabe

Die Funktion liefert neben allen Daten (Preis, Größe, Informationen, Heizarten, usw.) auch alle Attachments (z.B. Links zu Bilder) des Objekts zurück.

Parameter

exposeid - Die ID des Exposes ist ein Pflichtparameter. Dieser Parameter steht für die eindeutige ID des Objektes. Arbeitet man mit eigenen Objekten und möchte ein Objekt anhand einer eigenen ID aufrufen, so gibt man als "exposeid" einfach seine ID an und hängt davor ein "ext-" (z.B. "ext-12345678").

username - Wird nur beim Aufruf eigener Objekte über die Offer-API benötigt. Hier kann "me" für den eigenen Usernamen verwendet werden. Dafür muss die Applikation zertifiziert werden.

Attachments ermitteln

Entwickelt man eine Anwendung bei der die Medienelemente (z.B. Bilder) der Objekte im Vordergrund stehen, benötigt man evtl. nur die Mediendaten und nicht die kompletten Informationen zum Objekt. Hierfür steht die Funktion "getAttachment" zur Verfügung:

<?php

$aParameter = array('exposeid'=>12345678);
$res = $oImmocaster->getAttachment($aParameter);

?>

Rückgabe

Mit der genannten Funktion erhält man alle Anhänge (Multimedia-Daten) für ein Objekt.

Parameter

exposeid - Die ID des Exposes ist ein Pflichtparameter. Dieser Parameter übergibt die eindeutige ID des Objektes, dessen Anhänge ausgelesen werden sollen.

attachmentid - Optional kann der Funktion der Parameter "attachmentid" mit der ID des Anhangs (z.B. ein Bild) mitgegeben werden um nur diesen einzelnen Anhang auszulesen.

Impressum auslesen

Für das auslesen des Impressums, dass einem Objekt zugeordnet ist, benötigt man lediglich die ID des Objekts. Mit dieser ID kann dann folgende Funktion aufgerufen werden:

<?php

$aParameter = array('exposeid'=>12345678);
$res = $oImmocaster->getExposeImprint($aParameter);

?>

Rückgabe

Die Funktion liefert alle Informationen zurück, die der User für das Impressum des Exposes hinterlegt hat.

Parameter

exposeid - Die ID des Exposes ist ein Pflichtparameter und steht für die eindeutige ID des Objektes.