Άρθρα σχετικά με: Ακίνητα

Διαχείριση αγγελιών ακινήτων μέσω API (Οδηγός για Developers)

Αν είστε προγραμματιστής ή διαχειριστής συστήματος (CRM) και θέλετε να αυτοματοποιήσετε την εισαγωγή, ενημέρωση και διαγραφή των αγγελιών σας, μπορείτε να χρησιμοποιήσετε το Real Estate API μας.

🔗 Γρήγοροι Σύνδεσμοι (Quick Links)

1. Διαδικασία Ενεργοποίησης & Πιστοποίησης (Sandbox)

Πριν τη χρήση σε ζωντανό περιβάλλον (Production), απαιτείται η δοκιμή των βασικών σεναρίων σε δοκιμαστικό περιβάλλον:

Εγγραφή Χρήστη: Δημιουργήστε έναν απλό λογαριασμό χρήστηεδώ.
Αίτημα Credentials: Συμπληρώστε τηΦόρμα Εγγραφής CRM. Η ομάδα μας θα σας αποστείλει μέσω email τα client_id και client_secret για το Sandbox περιβάλλον ([https://api-sandbox.xe.gr/](https://api-sandbox.xe.gr/)).
Testing / Πιστοποίηση: Στείλτε email στο api-support@xe.gr για να λάβετε τα δοκιμαστικά σενάρια (δημιουργία, επεξεργασία, διαγραφή αγγελίας).
Παραγωγή (Live): Μόλις ολοκληρωθεί η πιστοποίηση, τα production credentials θα είναι διαθέσιμα στην ενότητα "Στοιχεία Διασυνδέσεων" του λογαριασμού σας.

2. Authentication (JWT Tokens)

Η πρόσβαση στο API ελέγχεται μέσω JWT Token. Εκδίδεται με POST κλήση (μορφή x-www-form-urlencoded) με τις παρακάτω παραμέτρους:

Path (Sandbox): [https://auth-sandbox.xe.gr/auth/realms/xe/protocol/openid-connect/token](https://auth-sandbox.xe.gr/auth/realms/xe/protocol/openid-connect/token)
Path (Production): [https://www.xe.gr/auth/realms/xe/protocol/openid-connect/token](https://www.xe.gr/auth/realms/xe/protocol/openid-connect/token)
Payload parameters: client_id, client_secret, grant_type=password, username, password, scope=openid profile email.

Μετά την επιτυχή κλήση, το token τοποθετείται στο Authorization Header των επόμενων αιτημάτων:
HTTP

Authorization: Bearer <YOUR_JWT_TOKEN>
Content-Type: application/json
Accept: application/json

3. Βασικά Endpoints & HTTP Methods

Όλες οι αλληλεπιδράσεις γίνονται με ανταλλαγή δεδομένων σε μορφή JSON. Το account_id του πελάτη πρέπει να περιλαμβάνεται στο σώμα (body) της κλήσης.

Εισαγωγή αγγελίας: POST /v1/real-estate/listings
Ενημέρωση αγγελίας (Τιμή, Χαρακτηριστικά): PUT /v1/real-estate/listings/{id}
Διαγραφή/Απενεργοποίηση αγγελίας: DELETE /v1/real-estate/listings/{id}
Έλεγχος status/Ανάκτηση αγγελιών: GET /v1/real-estate/listings

4. Διαχείριση Σφαλμάτων & Rate Limits

200 OK / 201 Created: Επιτυχής ενέργεια.
400 Bad Request: Λανθασμένο JSON schema ή έλλειψη υποχρεωτικών πεδίων.
401 Unauthorized: Μη έγκυρο ή ληγμένο Token.
429 Too Many Requests: Υπέρβαση ορίου κλήσεων (Rate limit: 1 token/sec και 5 tokens/min).

Tech Support: Για οποιοδήποτε σφάλμα κατά την υλοποίηση, επικοινωνήστε στο api-support@xe.gr επισυνάπτοντας το Error Log.

Ενημερώθηκε στις: 18/06/2026

Σας βοήθησε το συγκεκριμένο άρθρο;

Σας ευχαριστούμε!