Skip to content

[de] Installation

Norman Braun edited this page Oct 15, 2020 · 4 revisions

Die Installation ist relativ einfach. Du solltest composer bereits installiert haben. Die meisten Frameworks nutzen ebenfalls composer. Solltest du noch nicht composer nutzen, installiere bitte zuerst Composer.

Anschließend gibst du in deinem Commandozeilentool (z.B. Terminal) folgenden befehl im Root Verzeichnis deines Projektes ein: composer require pixelairport/scout-connect.

Jetzt kannst du das Paket laden und nutzen. Solltest du kein Framework nutzen, vergiss nicht die autoload.php aus dem Vendor Verzeichnis in deinem Script zu laden:

require_once '../vendor/autoload.php';

Jetzt kannst du deine Objekte von IS24 laden:

use Pixelairport\ScoutConnect\ImmoScout\User;

/**
 * Die Keys erhälst du bei IS24
 */
$key = 'MEIN_IS_KEY';
$secret = 'MEIN_IS_SECRET';
$access_token = 'abc123-ab12-ab12-ab12-123456abcdef';
$token_secret = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ123456789123456789123456789123456789123456789=';

// Mit IS24 verbinden
$is24 = new User($key, $secret, $access_token, $token_secret);

// Alle eigenen Objekte abrufen
$offers = $is24->findOffers();

// Objekte anzeigen
print_r($offers['data']);

Du erhälst mit dem Code die ersten zwanzig Objekte, da die Standardwert für pagesize 20 sind. Mit dem parameter pagenumber kannst du auf die nächste seite Blättern. Hier ein paar Beispiele:

// Zeige die Objekte 21-40
$offers = $is24->findOffers(['pagenumber'=>2]);

// Zeige die ersten 5 Objekte
$offers = $is24->findOffers(['pagesize'=>5]);

// Zeige die Objekte 11-15
$offers = $is24->findOffers(['pagesize'=>5, 'pagenumber'=>3]);

WICHTIG

Eines der größten Probleme die oft auftreten ist, dass die Nutzer die falschen Zugangsdaten nutzen. Bitte gehe zuerst zu https://rest.immobilienscout24.de/restapi/security/registration und leg einen Key und Secret an. Nun fehlen für das Codebeispiel noch $access_token und $token_secret. Die erhälst du im Playground von IS24.

  • Gehe auf https://playground.immobilienscout24.de/rest/playground
  • Wähle links oben "Use a own consumer key and secret" und gibt dein Key und Secret ein. Bestätige deine Auswahl.
  • Darunter findest du die Box "Request Helper Frame". Klicke dort auf den Button um dein Request Token zu erstellen.
  • Gehe weiter runter zur nächsten Box: "oAuth-Frame".
  • Klicke "Request Token".
  • Klicke "Authorize"
  • Jetzt sollte im Feld "Access Token" und "Token Secret" deine Daten für den Access stehen. Diese nutzt du für $access_token und $token_secret.
Clone this wiki locally