İçe aktarma / senkron REST API

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.

Başlayın

1. Herkese açık XML feed + ajans → API anahtarı: [email protected].
2. POST /rest-api/import/start → import-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'

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.

Kimlik doğrulama

• Header: API-KEY (önerilir)
• Alternatif (19.09.2026 itibarıyla kullanımdan kaldırılıyor): sorgu veya form parametresi apikey. URL içindeki anahtar erişim günlüklerine ve tarayıcı geçmişine düşer — API-KEY başlığına geçin; destek, bildirimden sonra kapatılacaktır.

Her kimlik doğrulama hatası, gövdesinde {"status":"error","message":"…"} bulunan HTTP 401 döndürür:

POST /rest-api/import/start

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": {
    "0": "success_with_warnings",
    "found_offers": 228,
    "published_found_offers_in_agency": 218,
    "imported_offers": 0,
    "published_offers": 0,
    "not_published": 10,
    "removed_offers": 0,
    "deleted_offers": 0,
    "updated_offers": 228,
    "errors": [{ "type": "…", "count": 10 }]
  },
  "logOffers": [{ "uuid": "…", "errors": [], "offerSourceData": { "offer_uid": "2080525" } }]
}

• "0", success veya success_with_warnings değeridir (hatalı ilanlar var demektir). errors hataları türe ve sayıya göre gruplar ve hata yoksa bulunmaz.
• İçe aktarma ilanlardan önce durursa (örneğin feed değişmemişse veya 30 günden eskiyse), logResult tek mesajlı bir dizidir: ["…"].

Limits

• Yöntem: POST
• Başlatma penceresi: 08:00–20:59 Bulgaristan saati
• Cooldown: zamanlanmış otomatik olanlar dahil, son içe aktarmadan itibaren 30 dakika
• Ajans başına bir aktif içe aktarma
• XML kuralları (<updated> için 30 günlük tazelik dahil): XML spesifikasyonu

Callback (result_url)

İçe aktarma sonrası Realistimo, XML'deki URL'ye (result_url) latest-log gibi bir JSON gövdesiyle POST yapar: message, logDate, logResult, logOffers. İstek bir kez gönderilir: hata durumunda veya URL erişilemezse tekrarlanmaz. Callback gelmezse /latest-log'u kontrol edin.

XML ve destek

• XML spesifikasyonu
• [email protected]