Getting started cu API-ul Imopedia.ro

Această pagină este punctul de orientare pentru o integrare nouă. Nu intră în detalii de implementare; fiecare zonă importantă are propriul capitol.

Date necesare înainte de implementare

Pentru sincronizarea unei agenții ai nevoie de:

user API;
parola API;
ID-ul agenției autorizate pentru publicare, transmis în câmpul AGENTIA, de exemplu 124.

Iei contact cu echipa Imopedia pentru a primi credențialele de acces și ID-ul agenției autorizate pentru publicare.
Te conectezi la webservice-ul SOAP și obții un session_id.
Verifici sau creezi agentul folosit în ofertă, astfel încât AGENT_ID să fie valid pentru AGENTIA.
Trimiți sau actualizezi oferta prin saveProperty.
Continui cu imagini și media doar după ce oferta a fost acceptată.
Folosești nomenclatoarele pentru câmpurile cu valori controlate.
Gestionezi erorile de validare și închizi sesiunea la final.

Endpoint-ul WSDL principal este:

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

Pentru o implementare cap-coadă, parcurge capitolele în această ordine:

Autentificare și sesiune - login, session_id, verificarea sesiunii și logout.
Structura ofertelor - câmpurile principale pentru publicarea unei proprietăți.
Validare și câmpuri recomandate - câmpurile care trebuie verificate înainte de saveProperty.
Nomenclatoare - valorile controlate folosite de câmpurile ofertelor.
Sincronizare - ordinea completă: agent, ofertă, media, reconciliere.
Fișiere media - imagini, video, addFile, existsFile și syncFiles.
Exemple - payload-uri și fragmente de cod.
Erori și depanare - erori frecvente și verificări de bază.