Aplicația de portofoliu pentru telefon Urmăriți proprietățile mai ușor. Descărcați din Google Play Google Play Aplicația de portofoliu pentru telefon Urmăriți proprietățile mai ușor. Descărcați din App Store App Store

REST API import / sincronizare

API pentru pornirea și monitorizarea importurilor. Format feed: Specificație XML.

Overview

Prezentare generală

Două endpoint-uri POST pentru pornirea și monitorizarea importurilor. Este necesară o cheie API. Importurile rulează asincron — după /start, verificați statusul cu /latest-log.

Tutorial

Începeți aici

  1. Feed XML public + agenție → cheie API de la [email protected].
  2. POST /rest-api/import/startimport-in-queue.
  3. Interogați POST /rest-api/import/latest-log până la 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

Cum sincronizați după modificări

  1. Actualizați XML-ul și setați un <updated> nou (valoarea neschimbată omite feed-ul).
  2. Actualizați <last_update> pentru ofertele modificate.
  3. POST /start. La cooldown sau import în curs, așteptați și reîncercați.
  4. Interogați /latest-log și corectați ofertele cu errors.
Reference

Autentificare

RăspunsCând
HTTP 401Cheie API lipsă sau goală
{"status":"error","message":"API key could not be found"}Cheie necunoscută
{"status":"error","message":"API key is inactive"}Cheie dezactivată
{"status":"error","message":"API key is expired"}Cheie expirată
{"status":"error","message":"User is inactive"} / User account is expiredProblemă cu contul de utilizator

POST /rest-api/import/start

messageSemnificație
import-in-queueAcceptat; importul este în coadă sau așteaptă deja
import-is-allowed-between-the-timeÎn afara ferestrei 08:00–20:59 (ora serverului)
import-in-progressUn import rulează deja
import-request-cooldown-is-time-givenAșteptați 30 de minute între cereri (production)
error-while-importingNiciun feed configurat pentru agenție
error: Agency not foundCheia nu este legată de o agenție

POST /rest-api/import/latest-log

message este statusul importului: pending | in_progress | completed (sau null dacă încă nu există). Când există 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)

După import, Realistimo trimite POST JSON în forma latest-log la result_url din XML. Callback-urile eșuate nu sunt reîncercate automat.

See also

XML & suport

Buletinul imobiliar

Astfel vei fi la curent cu noutățile imobiliare, statistici și știri de la Realistimo, fără spam:

V-ați înregistrat cu succes.
Vă rog să introduceți o adresă de e-mail. Vă rog să introduceți o adresă de e-mail valabilă. Vă rog să alegeți tipul de profil. Vă rugăm să introduceți un oraș. Vă rugăm să selectați un oraș din opțiunile din lista derulantă atunci când completați câmpul. A apărut o problemă. Vă rugăm să încercați mai târziu.
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4