Προδιαγραφή εισαγωγής XML

Καλώς ήρθατε στο European Real Estate Προδιαγραφή εισαγωγής XML. Αυτό το έγγραφο παρέχει όλες τις τεχνικές λεπτομέρειες που χρειάζεστε για να δημιουργήσετε μια ροή ιδιοτήτων που ενσωματώνεται στην πλατφόρμα μας.

Η ροή XML για τα ευρωπαϊκά ακίνητα είναι μια απόλυτη τροφοδοσία, που σημαίνει ότι θα πρέπει να περιέχει όλες τις ενεργές ιδιότητές σας κάθε φορά που δημιουργείται.

Πώς γίνεται η επεξεργασία των ιδιοτήτων

Τεχνικές απαιτήσεις

• Όλες οι ετικέτες XML ΠΡΕΠΕΙ να είναι πεζά
• Η ζωοτροφή ΠΡΕΠΕΙ να έχει κωδικοποίηση UTF-8
• Οι αλλαγές γραμμής στις περιγραφές πρέπει να χρησιμοποιούν πραγματικούς χαρακτήρες νέας γραμμής (\n)
• Do ΔΕΝ χρήση CDATA ενότητες και μην στέλνετε HTML σε <desc>
• Οι διευθύνσεις URL πρέπει να είναι απόλυτες (συμπεριλάβετε πλήρεις https:// πρόθεμα)
• Κάθε λογαριασμός απαιτεί μια μοναδική διεύθυνση URL ροής
• Οι κόμβοι ιδιότητας πρέπει να είναι άμεσα θυγατρικοί του <root>

Πρότυπα Μορφής Δεδομένων

Κάθε ροή ακολουθεί αυτήν τη βασική δομή: ένα ριζικό στοιχείο με την έκδοση μορφής, ακολουθούμενο από έναν κόμβο ιδιότητας ανά ενεργή ιδιότητα.

<?xml version="1.0" encoding="UTF-8"?>
<root>

<european_realestate>
<feed_version>2</feed_version>
</european_realestate>

<property>
<!-- Property 1 fields... -->
</property>

<property>
<!-- Property 2 fields... -->
</property>

<!-- Additional properties... -->

</root>

Τι διαβάζει η πλατφόρμα από την ροή δεδομένων

Κάθε στοιχείο παρακάτω ανήκει σε ένα μόνο <property> κόμβος. Τα ονόματα των στοιχείων είναι ακριβώς όπως γράφονται εδώ.

Βασικά Πεδία

<id>987654</id>

<ref>ABC-123</ref>

Τιμολόγηση

<price>250000</price>

<currency>EUR</currency>

<price_freq>sale</price_freq>

<country>Spain</country>

<town>Marbella</town>

<province>Málaga</province>

<postal_code>29600</postal_code>

<location_detail>Costa del Sol</location_detail>

<location>
<latitude>36.5108</latitude>
<longitude>-4.8855</longitude>
</location>

Λεπτομέρειες Ακινήτου

<type>Apartment</type>

<beds>3</beds>

<baths>2</baths>

<year_built>2020</year_built>

<surface_area>
<built>150</built>
<plot>500</plot>
</surface_area>

<energy_rating>
<consumption>B</consumption>
<emissions>C</emissions>
</energy_rating>

Περιεχόμενο

<desc>
<en>Beautiful modern apartment located in the heart of Marbella.</en>
</desc>

<url>
<en>https://example.com/property/123456</en>
</url>

Εικόνες / Βίντεο

<images>
<image>
<url>https://example.com/images/main.jpg</url>
</image>
<image>
<url>https://example.com/images/bedroom.jpg</url>
</image>
</images>

<virtual_tour_url>https://my.matterport.com/show/?m=XXXXX</virtual_tour_url>

<video_url>https://www.youtube.com/watch?v=XXXXX</video_url>

<features>
<feature>Swimming Pool</feature>
<feature>Sea views</feature>
<feature>Air Conditioning</feature>
</features>

Χρησιμοποιήστε αυτές τις τιμές για το <type> πεδίο. Η αντιστοίχιση δεν κάνει διάκριση πεζών-κεφαλαίων.

Διαμερισματα

Βίλες

Σπίτια της Πόλης

Εξοχικές κατοικίες

Γη & Ερείπια

Εμπορική ιδιοκτησία

Άλλα

Συμπεριλάβετε μόνο τα χαρακτηριστικά που ισχύουν για το ακίνητό σας, ένα <feature> στοιχείο για κάθε ένα. Χρησιμοποιήστε αυτά τα ονόματα. Η αντιστοίχιση δεν κάνει διάκριση πεζών-κεφαλαίων.

Χρησιμοποιήστε το όνομα της χώρας για το <country> πεδίο ή τον κώδικα ISO 3166-1 alpha-2.

Η ροή σας ΠΡΕΠΕΙ να έχει κωδικοποίηση UTF-8Οι ειδικοί χαρακτήρες στο περιεχόμενο κειμένου πρέπει να έχουν σωστή διαφυγή:

✅ Σωστό <en>Property with pool &amp; garden</en>

❌ Λάθος <en>Property with pool & garden</en>

Βήμα 1: Επικύρωση δομής XML

Επικυρώστε τη ροή σας με ένα εργαλείο επικύρωσης XML πριν την υποβάλετε:

• Υπηρεσία Επικύρωσης Σήμανσης W3C
• XMLValidation.com
• Τα περισσότερα σύγχρονα προγράμματα περιήγησης (ανοίξτε απευθείας το αρχείο XML)

Βήμα 2: Έλεγχος κωδικοποίησης χαρακτήρων

Επαληθεύστε ότι η ροή σας έχει κωδικοποιηθεί σωστά σε UTF-8:

• Έλεγχος Διεθνοποίησης W3C

Βήμα 3: Επαλήθευση Υποχρεωτικών Πεδίων

Κάθε ακίνητο χρειάζεται τα εξής στοιχεία:

• <id> — Μοναδικό αναγνωριστικό ακινήτου
• <price> — Τιμή ακινήτου
• <price_freq> — Πώληση ή ενοικίαση
• <type> — Τύπος ακινήτου
• <country> — Χώρα
• <town> — Πόλη ή κωμόπολη
• <desc><en> — Περιγραφή ακινήτου

Μόλις εγκριθεί η ροή σας, το σύστημά μας συγχρονίζει αυτόματα τις ιδιότητές σας κάθε βράδυ.

Χρονοδιάγραμμα συγχρονισμού

• Οι ροές δεδομένων υποβάλλονται σε αυτόματη επεξεργασία κάθε 24 ώρες
• Η επεξεργασία ξεκινά μετά 01:00 CEST και συνεχίζεται μέχρι τις πρώτες πρωινές ώρες
• Η επεξεργασία μεγάλων ροών ενδέχεται να διαρκέσει περισσότερο χρόνο.

Βέλτιστες Πρακτικές

• Να περιλαμβάνει πάντα ΟΛΕΣ οι ενεργές ιδιότητες στη ροή σας
• Κρατήστε το <id> ενός σταθερού ακινήτου για όλη τη διάρκεια ζωής του
• Αποστολή έως εικόνες 20 ανά ακίνητο· το πρώτο είναι η κάλυψη
• Αποστολή απόλυτων URL εικόνων που παραμένουν προσβάσιμες. Οι εικόνες λαμβάνονται μόνο μία φορά
• Βεβαιωθείτε ότι η διεύθυνση URL της ροής σας παραμένει συνεπής και προσβάσιμη
• Παρακολουθήστε τυχόν σφάλματα επικύρωσης που αναφέρονται από την ομάδα μας

Εάν έχετε ερωτήσεις ή αντιμετωπίζετε προβλήματα με τη ροή XML σας:

• Email: info@european.realestate
• Φόρμα Επικοινωνίας: european.realestate/contact

Όταν επικοινωνείτε με την υποστήριξη, παρακαλούμε συμπεριλάβετε:

• URL ροής σας
• Το όνομα του πρακτορείου σας στο European Real Estate
• Μερικά από τα <id> εμπλεκόμενες αξίες
• Περιγραφή του ζητήματος
• Οποιαδήποτε μηνύματα σφάλματος λαμβάνονται