API Imopedia.ro - Ghid de utilizare

Documentație publică pentru integrarea cu webservice-ul Imopedia.ro. API-ul este destinat partenerilor tehnici care publică, actualizează și sincronizează oferte imobiliare din sisteme externe.

Ce poți face cu API-ul

Prin API-ul Imopedia.ro poți:

• publica și actualiza oferte imobiliare;
• gestiona datele agenților asociați ofertelor;
• atașa imagini și resurse media;
• sincroniza lista de fișiere pentru o ofertă;
• folosi nomenclatoare controlate pentru câmpurile ofertelor.

Înainte să începi

Pentru acces la API trebuie să iei contact cu echipa Imopedia. Vei primi credențialele de autentificare și ID-ul agenției autorizate pentru publicare.

Endpointul SOAP principal este:

https://www.imopedia.ro/soap.wsdl

Pentru o integrare nouă, începe cu Getting started.

Flux de integrare

1. Obții accesul de la echipa Imopedia.
2. Te autentifici prin login și păstrezi session_id.
3. Publici sau actualizezi ofertele prin operațiile API.
4. Încarci imaginile și resursele media necesare.
5. Sincronizezi fișierele și verifici răspunsurile primite.
6. Închizi sesiunea prin logout.

Capitole

Start rapid

• Getting started - pașii mari ai unei integrări noi.
• Concepte - termenii de bază folosiți în documentație.
• Autentificare și sesiune - login, session_id, testLogin și logout.

Publicare oferte

• Operații API - operațiile SOAP disponibile și rolul fiecăreia.
• Structura ofertelor - câmpurile folosite la publicarea proprietăților.
• Validare și câmpuri recomandate - setul minim recomandat pentru publicare.
• Fișiere media - imagini, video și sincronizarea fișierelor.
• Sincronizare - fluxuri pentru creare, actualizare, ștergere și media.
• Nomenclatoare - valori controlate pentru câmpurile ofertelor.

Implementare

• Exemple - payload-uri și fragmente de cod.
• Erori și depanare - probleme frecvente și verificări recomandate.

Referințe

• Changelog - istoricul modificărilor documentației și câmpurilor.
• Secțiuni depreciate - informații istorice care nu mai sunt recomandate pentru implementări noi.

Referințe secundare

Următoarele documente sunt păstrate ca surse istorice sau auxiliare. Pentru implementare, folosește în primul rând fișierele versionate din această documentație.

• campuri & nomenclatoare - spreadsheet istoric cu nomenclatoare și câmpuri de proprietate.
• zone imopedia - spreadsheet istoric pentru nomenclatorul de zone.

Suport tehnic

Pentru detalii suplimentare, contactează departamentul tehnic Imopedia.ro la support@imopedia.ro.