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.
• Reguli de publicare - reguli editoriale pentru titlu și descriere.
• Fișiere media - imagini, video și sincronizarea fișierelor.
• Sincronizare - fluxuri pentru creare, actualizare, ștergere și media.
• Cum funcționează promovarea pe IMOPEDIA - campanii, limite și ordinea de afișare.
• Promovări și boost - integrarea tehnică pentru saveBoost, viewAgency și GOLD.
• 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.

Suport tehnic

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