Два 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 или running импорт изчакайте и опитайте отново./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>): спецификацияresult_url)След импорт Realistimo прави POST към URL от XML (result_url) с JSON тяло като latest-log. При грешка callback-ът не се повтаря автоматично.
Нека Realistimo да следи вместо теб
😃 Инсталирай приложението и ще те уведомим първи, когато се появи подходяща обява.
Така ще си в час с новото при имотите, статистики и новини от Реалистимо, без спам: