Δύο POST endpoints για έναρξη και παρακολούθηση εισαγωγών. Απαιτείται API key. Οι εισαγωγές εκτελούνται ασύγχρονα — μετά το /start, ελέγχετε την κατάσταση με /latest-log.
POST /rest-api/import/start → import-in-queue.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'
/start επιστρέφει πάντα {"message":"Import in queue"}, ενώ το /latest-log επιστρέφει την ίδια δειγματική απάντηση, όπου τα logResult και logOffers είναι JSON strings. Χρησιμοποιήστε το μόνο για να ελέγξετε τη σύνδεση.<updated> (ίδια τιμή παραλείπει το feed).<last_update> στις αλλαγμένες αγγελίες.POST /start. Σε cooldown ή ενεργή εισαγωγή, περιμένετε και ξαναδοκιμάστε./latest-log και διορθώστε αγγελίες με errors.API-KEY (προτεινόμενο)apikey στο query ή στη φόρμα. Ένα κλειδί μέσα στο URL καταλήγει σε αρχεία καταγραφής και στο ιστορικό του προγράμματος περιήγησης — χρησιμοποιήστε την κεφαλίδα API-KEY· η υποστήριξη θα διακοπεί μετά από ειδοποίηση.Κάθε σφάλμα ταυτοποίησης επιστρέφει 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 δεν συνδέεται με πρακτορείο |
{"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" } }]
}
"0" είναι success ή success_with_warnings (υπάρχουν αγγελίες με σφάλματα). Το errors ομαδοποιεί τα σφάλματα κατά τύπο και πλήθος και λείπει αν δεν υπάρχουν σφάλματα.logResult είναι πίνακας με ένα μήνυμα: ["…"].<updated>): Προδιαγραφή XMLresult_url)Μετά την εισαγωγή, η Realistimo κάνει POST στο URL από το XML (result_url) με σώμα JSON όπως το latest-log: message, logDate, logResult, logOffers. Το αίτημα αποστέλλεται μία φορά: σε περίπτωση σφάλματος ή μη προσβάσιμου URL δεν επαναλαμβάνεται. Αν το callback δεν φτάσει, ελέγξτε το /latest-log.
Άφησε το Realistimo να παρακολουθεί αντ' εσού
😃 Εγκαταστήστε την εφαρμογή και θα σας ειδοποιήσουμε πρώτους, όταν εμφανιστεί κατάλληλη αγγελία.
Έτσι θα είστε ενημερωμένοι με τα νέα στα ακίνητα, στατιστικά και ειδήσεις από το Realistimo, χωρίς spam: