Folgen Sie Immobilien einfacher.
Aus Google Play herunterladen
Folgen Sie Immobilien einfacher.
Aus dem App Store herunterladen
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.
POST /rest-api/import/start → import-in-queue.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'/start liefert immer {"message":"Import in queue"}, und /latest-log liefert dieselbe Beispielantwort, in der logResult und logOffers JSON-Strings sind. Verwenden Sie ihn nur zur Verbindungsprüfung.<updated> (unveränderter Wert überspringt den Feed).<last_update> bei geänderten Angeboten.POST /start. Bei Cooldown oder laufendem Import warten und erneut versuchen./latest-log pollen und Angebote mit errors korrigieren.API-KEY (empfohlen)apikey. Ein Schlüssel in der URL landet in Zugriffsprotokollen und im Browserverlauf – wechseln Sie zum Header API-KEY; die Unterstützung wird nach Ankündigung eingestellt.Jeder Authentifizierungsfehler liefert HTTP 401 mit dem Body {"status":"error","message":"…"}:
| message | Wann |
|---|---|
API key is missing in request | Fehlender oder leerer API-Schlüssel |
API key could not be found | Unbekannter Schlüssel |
API key is inactive | Deaktivierter Schlüssel |
API key is expired | Abgelaufener Schlüssel |
User is inactive | Benutzerkonto ist deaktiviert |
User account is expired | Benutzerkonto ist abgelaufen |
POST /rest-api/import/start| message | Bedeutung |
|---|---|
import-in-queue | Akzeptiert; Import ist in der Warteschlange oder wartet bereits |
import-is-allowed-between-the-time | Außerhalb des Fensters 08:00–20:59 (bulgarische Zeit) |
import-in-progress | Ein Import läuft bereits |
import-request-cooldown-is-time-given | Seit dem letzten Import — manuell oder automatisch — sind weniger als 30 Minuten vergangen |
error-while-importing | Kein Feed für die Agentur konfiguriert |
error: Agency not found | Schlüssel ist keiner Agentur zugeordnet |
{"error":"Agency not found"}. Prüfen Sie den Antwortkörper, nicht nur den Statuscode.POST /rest-api/import/latest-logmessage 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": {
"0": "success_with_warnings",
"found_offers": 228,
"published_found_offers_in_agency": 218,
"imported_offers": 0,
"published_offers": 0,
"not_published": 10,
"removed_offers": 0,
"deleted_offers": 0,
"updated_offers": 228,
"errors": [{ "type": "…", "count": 10 }]
},
"logOffers": [{ "uuid": "…", "errors": [], "offerSourceData": { "offer_uid": "2080525" } }]
}"0" ist success oder success_with_warnings (es gibt Angebote mit Fehlern). errors gruppiert die Fehler nach Art und Anzahl und fehlt, wenn es keine gibt.logResult ein Array mit einer einzigen Meldung: ["…"].<updated>): XML-Spezifikationresult_url)Nach dem Import sendet Realistimo per POST an die URL aus dem XML (result_url) einen JSON-Body wie latest-log: message, logDate, logResult, logOffers. Die Anfrage wird einmal gesendet: bei Fehler oder nicht erreichbarer URL wird sie nicht wiederholt. Kommt der Callback nicht an, prüfen Sie /latest-log.
Lass Realistimo für dich mitverfolgen
😃 Installieren Sie die App und wir benachrichtigen Sie zuerst, wenn ein passendes Angebot erscheint.
Mit dem Handy scannen, um die App herunterzuladen:
So bleiben Sie auf dem Laufenden über Neuigkeiten, Statistiken und Nachrichten von Realistimo, ohne Spam:
