Εφαρμογή χαρτοφυλακίου για τηλέφωνο Αναζητήστε και παρακολουθήστε ακίνητα πιο εύκολα. Λήψη από το Google Play Google Play Εφαρμογή χαρτοφυλακίου για τηλέφωνο Αναζητήστε και παρακολουθήστε ακίνητα πιο εύκολα. Λήψη από το 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/startimport-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'
How-to

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

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

Ταυτοποίηση

ΑπάντησηΠότε
HTTP 401Λείπει ή είναι κενό το API key
{"status":"error","message":"API key could not be found"}Άγνωστο key
{"status":"error","message":"API key is inactive"}Απενεργοποιημένο key
{"status":"error","message":"API key is expired"}Ληγμένο key
{"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Το key δεν συνδέεται με πρακτορείο

POST /rest-api/import/latest-log

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

Μετά την εισαγωγή, η Realistimo στέλνει POST JSON μορφής latest-log στο XML result_url. Αποτυχημένα callbacks δεν επαναλαμβάνονται αυτόματα.

See also

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

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

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

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