Два 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'
How-to
<updated> (без изменения значение пропускает feed).<last_update> у изменённых объявлений.POST /start. При cooldown или уже идущем импорте подождите и повторите./latest-log и исправляйте объявления с errors.API-KEY (рекомендуется)apikey| Ответ | Когда |
|---|---|
| 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-logmessage — статус импорта: 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
<updated>): Спецификация XMLresult_url)После импорта Realistimo отправляет POST JSON в формате latest-log на XML result_url. Неудачные callback не повторяются автоматически.
Пусть Realistimo следит вместо вас
😃 Установите приложение, и мы первыми сообщим вам, когда появится подходящее объявление.
Так вы будете в курсе новинок в области недвижимости, статистики и новостей от Realistimo, без спама: