Приложение для портфолио на телефон Следите за объектами недвижимости проще. Скачайте из Google Play Google Play Приложение для портфолио на телефон Следите за объектами недвижимости проще. Скачайте из App Store App Store

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

API для запуска и мониторинга импорта. Формат feed: Спецификация XML.

Overview

Обзор

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

Tutorial

Начало работы

  1. Публичный XML feed + агентство → API-ключ от [email protected].
  2. POST /rest-api/import/startimport-in-queue.
  3. Опрашивайте 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 или уже идущем импорте подождите и повторите.
  4. Опрашивайте /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

Limits

Callback (result_url)

После импорта Realistimo отправляет POST JSON в формате latest-log на XML result_url. Неудачные callback не повторяются автоматически.

See also

XML и поддержка

Новостная рассылка о недвижимости

Так вы будете в курсе новинок в области недвижимости, статистики и новостей от Realistimo, без спама:

Вы успешно зарегистрировались.
Пожалуйста, введите Имейл. Пожалуйста, введите действительный Емейл. Пожалуйста, выберите тип профиля. Пожалуйста, введите город. Пожалуйста, выберите город из вариантов в выпадающем списке при заполнении поля. Возникла проблема. Пожалуйста, попробуйте позже
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4