Приложение Realistimo Търси и следи имоти по-лесно. Изтегли от Google Play Google Play Приложение Realistimo Търси и следи имоти по-лесно. Изтегли от App Store App Store

REST API за импорт / синхронизация

API за стартиране и следене на импорт. Форматът на данните е в XML спецификацията.

Overview

Общ преглед

Два POST endpoint-а за стартиране и следене на импорт. Изисква се API ключ. Импортът се изпълнява асинхронно — след /start следете статуса през /latest-log.

Tutorial

Започнете тук

  1. Публичен XML feed + агенция → ключ от [email protected].
  2. POST /rest-api/import/startimport-in-queue.
  3. Poll 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'
How-to

Как да синхронизирате след промяна

  1. Обновете XML и поставете ново <updated> (иначе feed-ът се пропуска).
  2. Обновете <last_update> на променените оферти.
  3. POST /start. При cooldown или running импорт изчакайте и опитайте отново.
  4. Poll /latest-log и оправете оферти с errors.
Reference

Аутентификация

ОтговорКога
HTTP 401Липсващ или празен API ключ
{"status":"error","message":"API key could not be found"}Непознат ключ
{"status":"error","message":"API key is inactive"}Деактивиран ключ
{"status":"error","message":"API key is expired"}Изтекъл ключ
{"status":"error","message":"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 минути между заявки (production)
error-while-importingНяма конфигуриран feed за агенцията
error: Agency not foundКлючът не е свързан с агенция

POST /rest-api/import/latest-log

message е статусът на импорта: pending | in_progress | completed (или null, ако още няма статус). При наличен лог: 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

Ограничения

Callback (result_url)

След импорт Realistimo прави POST към URL от XML (result_url) с JSON тяло като latest-log. При грешка callback-ът не се повтаря автоматично.

See also

XML и помощ

Бюлетинът за недвижими имоти

Така ще си в час с новото при имотите, статистики и новини от Реалистимо, без спам:

Записахте се успешно.
Моля, въведете Имейл. Моля, въведете валиден Имейл. Моля, изберете Тип на профила. Моля, въведете град. Моля, изберете град от предложенията в падащия списък при попълването на полето. Излезе проблем. Моля, опитайте по-късно.
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4