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.
POST /rest-api/import/start → import-in-queue.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'
/start returnează întotdeauna {"message":"Import in queue"}, iar /latest-log returnează același răspuns exemplu, în care logResult și logOffers sunt șiruri JSON. Folosiți-o doar pentru a verifica conexiunea.<updated> nou (valoarea neschimbată omite feed-ul).<last_update> pentru ofertele modificate.POST /start. La cooldown sau import în curs, așteptați și reîncercați./latest-log și corectați ofertele cu errors.API-KEY (recomandat)apikey în query sau în formular. O cheie în URL ajunge în jurnalele de acces și în istoricul browserului — treceți la antetul API-KEY; suportul va fi oprit după notificare.Orice eroare de autentificare returnează HTTP 401 cu corpul {"status":"error","message":"…"}:
| message | Când |
|---|---|
API key is missing in request | Cheie API lipsă sau goală |
API key could not be found | Cheie necunoscută |
API key is inactive | Cheie dezactivată |
API key is expired | Cheie expirată |
User is inactive | Contul de utilizator este dezactivat |
User account is expired | Contul de utilizator a expirat |
POST /rest-api/import/start| message | Semnificație |
|---|---|
import-in-queue | Acceptat; importul este în coadă sau așteaptă deja |
import-is-allowed-between-the-time | În afara ferestrei 08:00–20:59 (ora Bulgariei) |
import-in-progress | Un import rulează deja |
import-request-cooldown-is-time-given | Au trecut mai puțin de 30 de minute de la ultimul import — manual sau automat |
error-while-importing | Niciun feed configurat pentru agenție |
error: Agency not found | Cheia nu este legată de o agenție |
{"error":"Agency not found"}. Verificați corpul răspunsului, nu doar codul de status.POST /rest-api/import/latest-logmessage 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": {
"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" este success sau success_with_warnings (există oferte cu erori). errors grupează erorile după tip și număr și lipsește dacă nu există erori.logResult este un array cu un singur mesaj: ["…"].<updated>): Specificație XMLresult_url)După import, Realistimo face un POST către URL-ul din XML (result_url) cu un corp JSON ca la latest-log: message, logDate, logResult, logOffers. Cererea este trimisă o singură dată: la eroare sau URL inaccesibil nu este reîncercată. Dacă callback-ul nu ajunge, verificați /latest-log.
Lasă Realistimo să urmărească în locul tău
😃 Instalează aplicația și te vom anunța primii când apare o anunț potrivit.
Astfel vei fi la curent cu noutățile imobiliare, statistici și știri de la Realistimo, fără spam: