> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.xe.gr/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

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

### 🔗 Γρήγοροι Σύνδεσμοι (Quick Links)
* [**Πλήρης Τεχνική Τεκμηρίωση & API Reference (Swagger) ➔**](https://docs.google.com/document/d/1-Qdgxt8WiHdYeaCtKMkMGDcbOQ_AjHgi33MLBt9n2Fw/edit?tab=t.0#heading=h.apupn7rbascr)
* [**Φόρμα Εγγραφής CRM / Integrator ➔**](https://docs.google.com/forms/d/e/1FAIpQLSdBbfaPwRSB6sF-4lRuynSm96bisgyiAvIcDh-M-ShBGeN85w/viewform)
* [**__FAQs Συχνές ερωτήσεις__**](https://docs.google.com/document/d/1-Qdgxt8WiHdYeaCtKMkMGDcbOQ_AjHgi33MLBt9n2Fw/edit?tab=t.6ae6xtz8abpw#heading=h.hvxcxbl2silf) [**__➔__**](https://docs.google.com/forms/d/e/1FAIpQLSdBbfaPwRSB6sF-4lRuynSm96bisgyiAvIcDh-M-ShBGeN85w/viewform) 

### 1. Διαδικασία Ενεργοποίησης & Πιστοποίησης (Sandbox)
Πριν τη χρήση σε ζωντανό περιβάλλον (Production), απαιτείται η δοκιμή των βασικών σεναρίων σε δοκιμαστικό περιβάλλον:
1. **Εγγραφή Χρήστη:** Δημιουργήστε έναν απλό λογαριασμό χρήστη [εδώ](https://www.xe.gr/account/sso).
2. **Αίτημα Credentials:** Συμπληρώστε τηΦόρμα Εγγραφής CRM. Η ομάδα μας θα σας αποστείλει μέσω email τα `client_id` και `client_secret` για το **Sandbox περιβάλλον** (`[https://api-sandbox.xe.gr/](https://api-sandbox.xe.gr/)`).
3. **Testing / Πιστοποίηση:** Στείλτε email στο [`api-support@xe.gr`](mailto:api-support@xe.gr) για να λάβετε τα δοκιμαστικά σενάρια (δημιουργία, επεξεργασία, διαγραφή αγγελίας).
4. **Παραγωγή (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/xxxxxxxx/listings`
* **Ενημέρωση αγγελίας (Τιμή, Χαρακτηριστικά):** `PUT /v1/xxxxxxxx/listings/{id}`
* **Παύση/Απενεργοποίηση αγγελίας:** `DELETE /v1/xxxxxxxx/listings/{id}`
* **Έλεγχος status/Ανάκτηση αγγελιών:** `GET /v1/xxxxxxxx/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`*](mailto:api-support@xe.gr) *επισυνάπτοντας το Error Log.*