Telefon için portföy uygulaması İlanları daha kolay takip edin. Google Play'den indirin Google Play Telefon için portföy uygulaması İlanları daha kolay takip edin. App Store'dan indirin App Store

İçe aktarma / senkron REST API

İçe aktarmaları başlatmak ve izlemek için API. Feed biçimi: XML spesifikasyonu.

Overview

Genel bakış

İçe aktarmaları başlatmak ve izlemek için iki POST uç noktası. API anahtarı gerekir. İçe aktarma asenkron çalışır — /start sonrası durumu /latest-log ile sorgulayın.

Tutorial

Başlayın

  1. Herkese açık XML feed + ajans → API anahtarı: [email protected].
  2. POST /rest-api/import/startimport-in-queue.
  3. completed olana kadar POST /rest-api/import/latest-log sorgulayın.
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

Feed değişince nasıl senkronize edilir

  1. XML’i güncelleyin ve yeni bir <updated> koyun (değişmeyen değer feed’i atlar).
  2. Değişen ilanlarda <last_update> değerini yenileyin.
  3. POST /start. Cooldown veya devam eden içe aktarmada bekleyip yeniden deneyin.
  4. /latest-log sorgulayın ve errors olan ilanları düzeltin.
Reference

Kimlik doğrulama

YanıtNe zaman
HTTP 401Eksik veya boş API anahtarı
{"status":"error","message":"API key could not be found"}Bilinmeyen anahtar
{"status":"error","message":"API key is inactive"}Devre dışı anahtar
{"status":"error","message":"API key is expired"}Süresi dolmuş anahtar
{"status":"error","message":"User is inactive"} / User account is expiredKullanıcı hesabı sorunu

POST /rest-api/import/start

messageAnlam
import-in-queueKabul edildi; içe aktarma kuyrukta veya zaten bekliyor
import-is-allowed-between-the-time08:00–20:59 penceresi dışında (sunucu saati)
import-in-progressBir içe aktarma zaten çalışıyor
import-request-cooldown-is-time-givenİstekler arasında 30 dakika bekleyin (production)
error-while-importingAjans için yapılandırılmış feed yok
error: Agency not foundAnahtar bir ajansa bağlı değil

POST /rest-api/import/latest-log

message içe aktarma durumudur: pending | in_progress | completed (henüz yoksa null). Log varsa: 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)

İçe aktarma sonrası Realistimo, XML result_url adresine latest-log biçiminde JSON POST eder. Başarısız callback’ler otomatik tekrarlanmaz.

See also

XML ve destek

Emlak Bülteni

Realistimo’dan emlak, istatistik ve haberler hakkında güncel kalın, spam yok:

Başarıyla kaydoldunuz.
Lütfen e-posta giriniz. Lütfen geçerli bir e-posta giriniz. Lütfen profil türü seçiniz. Lütfen bir şehir girin. Lütfen alanı doldururken açılır menüdeki seçeneklerden bir şehir seçin. Bir sorun oluştu. Lütfen daha sonra tekrar deneyin.
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4