Εφαρμογή Realistimo Αναζητήστε και παρακολουθήστε ακίνητα πιο εύκολα. Λήψη από το Google Play Google Play Εφαρμογή Realistimo Αναζητήστε και παρακολουθήστε ακίνητα πιο εύκολα. Λήψη από το App Store App Store

REST API εισαγωγής / συγχρονισμού

API για έναρξη και παρακολούθηση εισαγωγών. Μορφή feed: Προδιαγραφή XML.

Overview

Επισκόπηση

Δύο POST endpoints για έναρξη και παρακολούθηση εισαγωγών. Απαιτείται API key. Οι εισαγωγές εκτελούνται ασύγχρονα — μετά το /start, ελέγχετε την κατάσταση με /latest-log.

Tutorial

Ξεκινήστε εδώ

  1. Δημόσιο XML feed + πρακτορείο → API key από [email protected].
  2. POST /rest-api/import/start → import-in-queue.
  3. Κάντε poll το 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'
Το δοκιμαστικό API key δεν ξεκινά εισαγωγή: το /start επιστρέφει πάντα {"message":"Import in queue"}, ενώ το /latest-log επιστρέφει την ίδια δειγματική απάντηση, όπου τα logResult και logOffers είναι JSON strings. Χρησιμοποιήστε το μόνο για να ελέγξετε τη σύνδεση.
How-to

Πώς να συγχρονίσετε μετά από αλλαγές

  1. Ενημερώστε το XML και ορίστε νέο <updated> (ίδια τιμή παραλείπει το feed).
  2. Ανανεώστε το <last_update> στις αλλαγμένες αγγελίες.
  3. POST /start. Σε cooldown ή ενεργή εισαγωγή, περιμένετε και ξαναδοκιμάστε.
  4. Κάντε poll το /latest-log και διορθώστε αγγελίες με errors.
Reference

Ταυτοποίηση

Κάθε σφάλμα ταυτοποίησης επιστρέφει HTTP 401 με σώμα {"status":"error","message":"…"}:

messageΠότε
API key is missing in requestΛείπει ή είναι κενό το API key
API key could not be foundΆγνωστο key
API key is inactiveΑπενεργοποιημένο key
API key is expiredΛηγμένο key
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 λεπτά από την τελευταία εισαγωγή — χειροκίνητη ή αυτόματη
error-while-importingΔεν υπάρχει ρυθμισμένο feed για το πρακτορείο
error: Agency not foundΤο key δεν συνδέεται με πρακτορείο
Αυτές οι απαντήσεις έρχονται με HTTP 200, συμπεριλαμβανομένου του {"error":"Agency not found"}. Ελέγχετε το σώμα της απάντησης, όχι μόνο τον κωδικό κατάστασης.

POST /rest-api/import/latest-log

Το message είναι η κατάσταση εισαγωγής: pending | in_progress | completed (ή null αν δεν υπάρχει ακόμα). Όταν υπάρχει log: 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" } }]
}
Reference

Limits

Callback (result_url)

Μετά την εισαγωγή, η Realistimo κάνει POST στο URL από το XML (result_url) με σώμα JSON όπως το latest-log: message, logDate, logResult, logOffers. Το αίτημα αποστέλλεται μία φορά: σε περίπτωση σφάλματος ή μη προσβάσιμου URL δεν επαναλαμβάνεται. Αν το callback δεν φτάσει, ελέγξτε το /latest-log.

See also

XML & υποστήριξη

Το δελτίο ακινήτων

Έτσι θα είστε ενημερωμένοι με τα νέα στα ακίνητα, στατιστικά και ειδήσεις από το Realistimo, χωρίς spam:

Εγγραφήκατε επιτυχώς.
Παρακαλώ εισάγετε Email. Παρακαλώ εισάγετε έγκυρο Email. Παρακαλώ επιλέξτε Τύπο προφίλ. Παρακαλώ εισάγετε πόλη. Παρακαλώ επιλέξτε πόλη από τις προτάσεις στο αναπτυσσόμενο μενού κατά τη συμπλήρωση του πεδίου. Προέκυψε πρόβλημα. Παρακαλώ δοκιμάστε αργότερα.
US AIzaSyBR3omDZNtlfDZ-DUvziDqXSz06vDg5mk4