Portfolio-App für das Handy Folgen Sie Immobilien einfacher. Aus Google Play herunterladen Google Play Portfolio-App für das Handy Folgen Sie Immobilien einfacher. Aus dem App Store herunterladen App Store

Import- / Sync-REST-API

API zum Starten und Überwachen von Importen. Feed-Format: XML-Spezifikation.

Overview

Überblick

Zwei POST-Endpunkte zum Starten und Überwachen von Importen. Ein API-Schlüssel ist erforderlich. Importe laufen asynchron — nach /start den Status mit /latest-log abfragen.

Tutorial

Erste Schritte

  1. Öffentlicher XML-Feed + Agentur → API-Schlüssel von [email protected].
  2. POST /rest-api/import/startimport-in-queue.
  3. POST /rest-api/import/latest-log pollen, bis completed.
curl -X POST 'https://realistimo.com/rest-api/import/start' \
  -H 'Accept: application/json' \
  -H 'API-KEY: YourApiKeyHere'

curl -X POST 'https://realistimo.com/rest-api/import/latest-log' \
  -H 'Accept: application/json' \
  -H 'API-KEY: YourApiKeyHere'
How-to

So synchronisieren Sie nach Feed-Änderungen

  1. Aktualisieren Sie das XML und setzen Sie ein neues <updated> (unveränderter Wert überspringt den Feed).
  2. Erhöhen Sie <last_update> bei geänderten Angeboten.
  3. POST /start. Bei Cooldown oder laufendem Import warten und erneut versuchen.
  4. /latest-log pollen und Angebote mit errors korrigieren.
Reference

Authentifizierung

AntwortWann
HTTP 401Fehlender oder leerer API-Schlüssel
{"status":"error","message":"API key could not be found"}Unbekannter Schlüssel
{"status":"error","message":"API key is inactive"}Deaktivierter Schlüssel
{"status":"error","message":"API key is expired"}Abgelaufener Schlüssel
{"status":"error","message":"User is inactive"} / User account is expiredProblem mit dem Benutzerkonto

POST /rest-api/import/start

messageBedeutung
import-in-queueAkzeptiert; Import ist in der Warteschlange oder wartet bereits
import-is-allowed-between-the-timeAußerhalb des Fensters 08:00–20:59 (Serverzeit)
import-in-progressEin Import läuft bereits
import-request-cooldown-is-time-given30 Minuten zwischen Anfragen warten (Production)
error-while-importingKein Feed für die Agentur konfiguriert
error: Agency not foundSchlüssel ist keiner Agentur zugeordnet

POST /rest-api/import/latest-log

message ist der Importstatus: pending | in_progress | completed (oder null, falls noch keiner). Bei vorhandenem Log: logDate, logResult, logOffers (uuid, createdAt, errors, offerSourceData).

{
  "message": "completed",
  "logDate": "2024-09-18T01:51:14+03:00",
  "logResult": { "found_offers": 228, "updated_offers": 228, "not_published": 10 },
  "logOffers": [{ "uuid": "…", "errors": [], "offerSourceData": { "offer_uid": "2080525" } }]
}
Reference

Limits

Callback (result_url)

Nach dem Import sendet Realistimo JSON im latest-log-Format per POST an die XML-result_url. Fehlgeschlagene Callbacks werden nicht automatisch wiederholt.

See also

XML & Support

Der Immobilien-Newsletter

So bleiben Sie auf dem Laufenden über Neuigkeiten, Statistiken und Nachrichten von Realistimo, ohne Spam:

Sie haben sich erfolgreich registriert.
Bitte E-Mail Email-Adresse eingeben. Bitte geben Sie eine gültige Email-Adresse ein. Bitte Kontotyp auswählen. Bitte geben Sie eine Stadt ein. Bitte wählen Sie eine Stadt aus den Optionen in der Dropdown-Liste aus, wenn Sie das Feld ausfüllen. Es gab ein Problem. Bitte versuchen Sie es später erneut.
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4