İlan içe aktarma için XML feed

Realistimo'ya ilan içe aktarmak için bir XML feed nasıl hazırlanır. On-demand sync için REST API sayfasına bakın.

Overview

Genel bakış

XML (bu sayfa)

Feed'de ne yayınlanacağı ve import'un alanları nasıl okuduğu.

REST

API key, POST /start, POST /latest-log, limitler ve isteğe bağlı callback.

Tutorial

Başlayın

Aşağıdaki minimal örneği kopyalayın veya daha dolu bir örnek XML indirin.
agency_uid değerini Realistimo'nun acentenize verdiği source id yapın; broker_id değerlerini Realistimo'da zaten bağlı agent source id'leri yapın.
Kararlı bir offer_uid, category/subcategory, konum (internal_id), images, price, description, currency=eur ile ilanlar ekleyin.
Feed'i genel bir HTTPS URL'de barındırın ve [email protected] adresine gönderin.
Manuel sync için: REST tutorial.

Geo lookup dosyaları: CSV · PostgreSQL dump

Explanation

Senkronizasyon nasıl çalışır

Feed seviyesi: <updated> feed sürümüdür. Son başarılı sync'ten beri değişmediyse import atlanır.
Eski feed: <updated> 30 günden eski bir tarih olarak parse edilirse işlem durur.
İlan seviyesi: yayınlanmış bir ilanda <last_update> varsa ve son içe aktarılan değişiklikten daha yeni değilse çoğu alan atlanır (fiyat, agent ataması ve açıklama yine güncellenir). Boş/eksik <last_update> bu skip'i tetiklemez.
Eksik ilanlar: feed'de olmayan ilanlar normal bir import çalıştırmasında kaldırılır/arşivlenir.
Eksik isteğe bağlı XML tag'leri boş kabul edilir — her isteğe bağlı tag gerekli değildir.

Aşağıdaki «Zorunlu» şu anlama gelir: değer olmadan import/yayın genellikle başarısız olur veya ilan yayınlanmamış kalır. Birçok attribute'un varsayılan değerleri vardır.

How-to

Feed nasıl hazırlanır

Root <feed>, broker'lar <Brokers> içinde, ilanlar <offers> içinde.
Konum: geo dosyalarından şehrin, kasabanın/köyün veya mahallenin internal_id'si. Bu olmadan konum açıklamada aranır; bulunamazsa ilan yayınlanmamış kalır.
Para birimi: eur gönderin.
Her gerçek değişiklikte feed <updated> ve etkilenen ilanlarda <last_update> değerlerini güncelleyin.
URL, sunucu taraflı istemciler tarafından erişilebilir olmalıdır (etkileşimli Cloudflare challenge olmamalı).

Reference

Minimal örnek

Bu iskeleti kopyalayın, placeholder'ları değiştirin ve güncel timestamp'ler koyun (YYYY-MM-DD HH:MM:SS, 30 günden eski olmamalı).

<?xml version="1.0" encoding="UTF-8"?>
<feed>
  <updated>YYYY-MM-DD HH:MM:SS</updated>
  <agency_uid>YOUR_AGENCY_SOURCE_ID</agency_uid>
  <Brokers>
    <Broker>
      <BrokerID>YOUR_AGENT_SOURCE_ID</BrokerID>
      <BrokerName>Ivan Ivanov</BrokerName>
      <BrokerPhone>0888000000</BrokerPhone>
      <BrokerEmail>[email protected]</BrokerEmail>
    </Broker>
  </Brokers>
  <offers>
    <offer>
      <offer_uid>offer-1</offer_uid>
      <last_update>YYYY-MM-DD HH:MM:SS</last_update>
      <description>Test listing</description>
      <images>https://example.com/a.jpg</images>
      <price>100000</price>
      <surface>70</surface>
      <currency>eur</currency>
      <category>продажби</category>
      <subcategory>2-СТАЕН</subcategory>
      <internal_id>8545</internal_id>
      <broker_id>YOUR_AGENT_SOURCE_ID</broker_id>
    </offer>
  </offers>
</feed>

Daha dolu örnek XML indir (şekil referansı — yine de id'leri, timestamp'leri ve içeriği sizinkilerle değiştirin).

Agency

Tag	Açıklama	Notlar
`<updated>`	Feed sürümü / tarihi	Zorunlu İçerik değişince değişmeli; en fazla 30 gün eski
`<agency_uid>`	Acente source id	Zorunlu Acenteniz için yapılandırılmış id ile eşleşmeli
`<agency_name>`, `<agency_phone>`, `<agency_email>`	Metadata	İsteğe bağlı Import tarafından kullanılmaz; uyumluluk için güvenli
`<result_url>`	Import sonrası callback	İsteğe bağlı Realistimo latest-log şeklinde JSON gövdesi POST eder; bkz. REST

Brokers

<Brokers>/<Broker> feed için broker iletişim bilgilerini sağlar. İlan broker_id, Realistimo'da acentenize zaten bağlı bir agent source id ile eşleşmelidir (entegrasyon sırasında ayarlanır). XML BrokerID değerleri aynı id'leri kullanmalıdır. broker_id değeri bağlı bir agent ile eşleşmeyen bir ilan, ajans için yedek bir agent ayarlanmadıkça içe aktarılmaz.

Tag	Notlar
`<BrokerID>`	Zorunlu Agent source id (tercihen ≠ `agency_uid`)
`<BrokerName>`	Zorunlu Ad (+ soyad)
`<BrokerPhone>`, `<BrokerEmail>`, `<BrokerPhoto>`	İsteğe bağlı

Offers (desteklenen alanlar)

Tag	Açıklama	Notlar
`<last_update>`	İlan değişiklik zamanı	Önerilen Tarih/saat veya unix timestamp. Varsa ve son içe aktarılan değişiklikten daha yeni değilse, yayınlanmış ilanlarda çoğu alan atlanır
`<offer_uid>`	Kararlı id	Zorunlu Düzenlemelerde değiştirmeyin
`<offer_code>`	Referans kodu	İsteğe bağlı
`<title>`	Başlık parçası	İsteğe bağlı Açıklamadan ayrı
`<description>`	Açıklama	Önerilen Yayın için güçlü şekilde istenir
`<images>`	URL'ler	Zorunlu Ayırıcı `;`
`<price>`	Fiyat	Zorunlu Sadece rakamlar, binlik ayırıcı olmadan: ilk virgül veya noktadan sonrası kesilir (`100,000` 100 olarak içe aktarılır). Boşluklar sorun çıkarmaz. `0` veya `1` = «Pazarlık edilebilir fiyat». Parent bina/kompleks için fiyat sıfırlanır
`<surface>`	Alan m²	Zorunlu Çoğu tip için gereklidir. Garaj ve otopark yeri için alan yoksa 18 m² yazılır. Arazi için bkz. arsa ve arazi
`<surface_parcel>`	Bahçe/arsa	İsteğe bağlı Bahçenin m² cinsinden alanı. `surface` eksikse mülkün alanı olarak da kullanılır
`<currency>`	Para birimi	Zorunlu `eur`. Eksikse fiyat neredeyse yarı değerinde gösterilir.
`<category>`	`продажби` / `наеми`	Zorunlu
`<subcategory>`	Mülk tipi	Zorunlu Desteklenen tam bir değer olmalı (aşağıya bakın)
`<internal_id>`	Geo internal id	Zorunlu Geo dosyalarından şehrin, kasabanın/köyün veya mahallenin id'si. Eksik veya hatalıysa konum açıklamada aranır; bulunamazsa ilan yayınlanmamış kalır
`<subregion_id>`	Mapped location id	İsteğe bağlı Yalnızca bazı eski entegrasyonlar tarafından kullanılır. Buna güvenmeyin — `internal_id` gönderin
`<construction_type>`	епк / панел / тухла / гредоред	İsteğe bağlı Yalnızca küçük harflerle, bkz. değerler
`<floor>`, `<floorAll>`	Kat / katlar	İsteğe bağlı `floor` değeri `0` yok sayılır
`<building_condition>`	İnşaat aşaması	İsteğe bağlı Bkz. değerler
`<build_year>`	YYYY-MM-DD / YYYY	İsteğe bağlı Tam tarih veya yalnızca yıl (`2005`). Tek başına yıl, 1800'den 10 yıl sonrasına kadar kabul edilir; aksi halde yok sayılır. Daha eski binalar bir dönem olarak gösterilir («1989 yılından öncesi» veya «1990 ve 2004 arası»)
`<furnished>`	0 / 14 / 23 / 65	İsteğe bağlı `14` = döşeli, `65` = kısmen döşeli, `0` ve `23` = eşyasız. Eksik veya farklı bir değer, açıklamada «döşeli» yazsa bile «Emin değilim» olarak kaydedilir — bu yüzden tag'i her zaman gönderin
`<heating_ids>`	`,` ile ID'ler	İsteğe bağlı 4, 6 ve 18 = katı yakıt, 35 = klima, 44 = elektrik, 46 = merkezi ısıtma, 80 = gaz. Diğer id'ler yok sayılır
`<parking_ids>`	52, 93	İsteğe bağlı 52 = garaj, 93 = otopark yeri. Diğer id'ler yok sayılır
`<rooms_count>`, `<bedroom_count>`, `<bath_count>`	Sayılar	İsteğe bağlı Bkz. varsayılan değerler
`<exterior_ids>`	`,` ile ID'ler	İsteğe bağlı 42 = asansör, 10 = asfalt yol. Diğer id'ler yok sayılır
`<broker_id>`	Agent source id	Zorunlu Realistimo'da bağlı bir agent ile eşleşmeli
`<construction_id>`	Parent offer_uid	İsteğe bağlı Bina/kompleks how-to'ya bakın
`<youtube_link>` / `<youTube_link>`	YouTube	İsteğe bağlı
`<virtual_panorama_link>`	Sanal tur	İsteğe bağlı Matterport, Giraffe360, CloudPano, Panoee, imot360, Zelanos, Renderimo, Webobook ve Kuula (kısa bit.ly bağlantısı) bağlantıları tanınır. Diğer bağlantılar, yayını engellemeden atlanır
`<Exclusive>`	0/1	İsteğe bağlı

Değerler

subcategory (desteklenen değerler)

СТАЯ, АПАРТАМЕНТ, ЕДНОСТАЕН, БОКСИОНЕРА, СТУДИО, 1-СТАЕН, 2-СТАЕН, 3-СТАЕН, 4-СТАЕН, МНОГОСТАЕН, МЕЗОНЕТ, ГАРСОНИЕРА, ГАРСОНИЕРА ЛУКС
АТЕЛИЕ · АТЕЛИЕ, ТАВАН · ТАВАН · ЕТАЖ ОТ КЪЩА · КЪЩА · ВИЛА
ОФИС, МАГАЗИН, ТЪРГОВСКИ ОБЕКТ, ЗАВЕДЕНИЕ, СПОРТ, САЛОН ЗА КРАСОТА, СКЛАД, ГАРАЖ, ПАРКОМЯСТО, ПРОМ. ПОМЕЩЕНИЕ, ХОТЕЛ
БИЗНЕС ИМОТ, ДРУГО — ticari gayrimenkul
ПАРЦЕЛ, ЗЕМЕДЕЛСКА ЗЕМЯ — bkz. arsa ve arazi
СГРАДИ, СГРАДА — fiyatlı bütün bina (construction_id için parent değil)
НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО — parent construction
ЗАТВОРЕН КОМПЛЕКС — parent complex

Değerleri listede olduğu gibi, büyük harflerle gönderin (Kiril). Bilinmeyen değerler ilan import'unun başarısız olmasına yol açar.

building_condition

Completed (veya bds-completed) — Akt 16 ile
SemiCompleted (veya semi_completed) — Akt 15 ile
NotCompleted (veya not_completed) — Akt 14 ile
UnderConstruction — İnşaat halinde/inşaat izni ile
PreConstruction (veya pre_construction) — Yeşil üzerinde (kavramsal proje)

Büyük ve küçük harfler önemlidir.

construction_type

епк — EPK (sürünen kalıp)
панел — Panel yapı
тухла — Tuğla (beton levhalarla)
гредоред — Tuğla (kirişler)

Sadece küçük harflerle: Тухла tanınmaz.

Varsayılan değerler

Bir tag eksik veya boşsa, içe aktarma şunu kaydeder:

Tag	Varsayılan değer
`<heating_ids>`	Elektrik
`<rooms_count>`	Daire için — `subcategory`'ye göre (`2-СТАЕН` = 2), aksi halde 1
`<bedroom_count>`	Oda sayısı eksi 1, en az 1
`<bath_count>`	1, ancak oda sayısından fazla olmaz
`<building_condition>`	Akt 16 ile
`<construction_type>`	Emin değilim (yalnızca satışta)
`<furnished>`	Emin değilim (tüm tiplerde)
`<surface>`	Belirtilmişse açıklamadaki alan; garaj ve otopark yeri için — 18 m²

Isıtma, oda, yatak odası, banyo, inşaat aşaması ve yapı tipi; arsa, tarım arazisi, garaj, otopark yeri ve yeni bina için doldurulmaz.

Yok sayılan tag'ler

Bu tag'ler import sırasında uygulanmaz. Feed'de görünebilirler ancak ilan üzerinde etkisi yoktur: balcony_count, land_category, parcel_in_regulation, new_construction.

How-to

Bina / kompleks → daireler

Parent: subcategory şunlardan biri: НОВА СГРАДА, СГРАДА НОВО СТРОИТЕЛСТВО, ЗАТВОРЕН КОМПЛЕКС.
Child: <construction_id>PARENT_OFFER_UID</construction_id>.
XML'deki sıra önemli değil. Boş tag bağlantıyı temizler. Self-ref / geçersiz parent yok sayılır.

Arsa ve arazi

Arsa için ayrı tag yoktur — sıradan bir ilan gibi gönderilir:

İnşaata uygun arsa için <subcategory>ПАРЦЕЛ</subcategory> veya tarım arazisi için ЗЕМЕДЕЛСКА ЗЕМЯ. Orman, bağ, mera ve meyve bahçesi şimdilik gönderilemez.
<surface>, mülkün m² cinsinden alanıdır. 0 ile 1 arasındaki bir değer dönüm olarak okunur: 0.8 = 800 m² (virgülle değil, nokta ile). surface eksikse surface_parcel, ardından açıklamadaki alan kullanılır.
Şehrin veya kasabanın/köyün <internal_id>'si yeterlidir — mahalle zorunlu değildir.
Oda, kat, yapı tipi ve mobilya bilgisi gerekmez.
Asfalt yol: <exterior_ids>10</exterior_ids>. Elektrik ve su için tag yoktur — (Bulgarca) açıklamaya tam olarak «ток и вода на граница» yazın (ya da yalnızca «ток на граница» / «вода на граница»). Başka ifadeler tanınmayabilir.
Kullanım amacı da (Bulgarca) açıklamadan okunur. Orada belirtilmemişse, ПАРЦЕЛ için «Konut yapısı» ve «Ticari yapı» kaydedilir; ЗЕМЕДЕЛСКА ЗЕМЯ için alan boş kalır.
land_category ve parcel_in_regulation yok sayılır.

<offer>
  <offer_uid>parcel-1</offer_uid>
  <last_update>YYYY-MM-DD HH:MM:SS</last_update>
  <title>Парцел в село Лозен</title>
  <description>Равен парцел с лице към улица. Ток и вода на граница.</description>
  <images>https://example.com/p1.jpg;https://example.com/p2.jpg</images>
  <price>85000</price>
  <surface>1200</surface>
  <currency>eur</currency>
  <category>продажби</category>
  <subcategory>ПАРЦЕЛ</subcategory>
  <internal_id>9433</internal_id>
  <exterior_ids>10</exterior_ids>
  <broker_id>YOUR_AGENT_SOURCE_ID</broker_id>
</offer>