Търси и следи имоти по-лесно.
Изтегли от Google Play
Търси и следи имоти по-лесно.
Изтегли от App Store
Два POST endpoint-а за стартиране и следене на импорт. Изисква се API ключ. Импортът се изпълнява асинхронно — след /start следете статуса през /latest-log.
POST /rest-api/import/start → import-in-queue.POST /rest-api/import/latest-log до 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 винаги връща {"message":"Import in queue"}, а /latest-log — един и същ примерен отговор, в който logResult и logOffers са JSON низове. Ползвайте го само за проверка на връзката.<updated> (иначе feed-ът се пропуска).<last_update> на променените оферти.POST /start. При cooldown или running импорт изчакайте и опитайте отново./latest-log и оправете оферти с errors.API-KEY (препоръчително)apikey в заявката или във формата. Ключ в адреса попада в логове и в историята на браузъра — преминете към хедъра API-KEY; поддръжката ще бъде спряна след предизвестие.Всяка грешка при аутентикация връща HTTP 401 с тяло {"status":"error","message":"…"}:
| message | Кога |
|---|---|
API key is missing in request | Липсващ или празен API ключ |
API key could not be found | Непознат ключ |
API key is inactive | Деактивиран ключ |
API key is expired | Изтекъл ключ |
User is inactive | Потребителят е деактивиран |
User account is expired | Потребителският акаунт е изтекъл |
POST /rest-api/import/start| message | Значение |
|---|---|
import-in-queue | Заявката е приета; импортът е на опашка или вече чака |
import-is-allowed-between-the-time | Извън работния прозорец 08:00–20:59 българско време |
import-in-progress | Вече има активен импорт |
import-request-cooldown-is-time-given | Минали са по-малко от 30 минути от последния импорт — ръчен или автоматичен |
error-while-importing | Няма конфигуриран feed за агенцията |
error: Agency not found | Ключът не е свързан с агенция |
{"error":"Agency not found"}. Проверявайте тялото на отговора, не само статус кода.POST /rest-api/import/latest-logmessage е статусът на импорта: pending | in_progress | completed (или null, ако още няма статус). При наличен лог: 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" е success или success_with_warnings (има оферти с грешки). errors групира грешките по вид и брой и липсва, ако няма грешки.logResult е масив с едно съобщение: ["…"].<updated>): спецификацияresult_url)След импорт Realistimo прави POST към URL от XML (result_url) с JSON тяло като latest-log: message, logDate, logResult, logOffers. Заявката се изпраща веднъж: при грешка или недостъпен URL не се повтаря. Ако callback не пристигне, проверете /latest-log.
Нека Realistimo да следи вместо теб
😃 Инсталирай приложението и ще те уведомим първи, когато се появи подходяща обява.
Сканирай с телефона, за да изтеглиш приложението:
Така ще си в час с новото при имотите, статистики и новини от Реалистимо, без спам:
