Sincronizare

Acest capitol explică ordinea recomandată a operațiilor pentru publicarea și menținerea ofertelor în Imopedia.ro.

Principii

• Folosește același ID_LOCAL pentru aceeași ofertă din sistemul sursă.
• Trimite AGENTIA în payload pentru oferta sau fișierul sincronizat.
• Actualizează oferta înainte de a sincroniza fișierele asociate.
• Verifică răspunsurile API și tratează separat erorile față de warnings.

Flux pentru creare ofertă

1. Apelează login și păstrează session_id.
2. Construiește payload-ul ofertei cu AGENTIA, ID_LOCAL, tipul imobilului, tranzacția, prețul și datele de localizare.
3. Apelează saveProperty.
4. Dacă oferta are imagini, verifică fiecare fișier prin existsFile.
5. Încarcă fișierele lipsă prin addFile.
6. Apelează syncFiles dacă vrei ca lista finală de fișiere să rămână exact cea transmisă.
7. Apelează syncChannel când este necesară propagarea sincronizării pentru oferta indicată.
8. Apelează logout.

Flux pentru actualizare ofertă

Pentru actualizare, retrimite oferta prin saveProperty folosind același ID_LOCAL. API-ul tratează payload-ul ca actualizare a ofertei existente în contextul agenției.

Actualizează apoi media separat:

1. Verifică fișierele existente prin existsFile.
2. Încarcă fișierele noi prin addFile.
3. Trimite lista finală prin syncFiles, dacă fișierele eliminate din sistemul sursă trebuie eliminate și din Imopedia.ro.

Flux pentru ștergere ofertă

Pentru eliminarea unei oferte publicate, folosește deleteProperty cu identificatorul ofertei. După ștergere, nu mai trimite fișiere pentru acea ofertă.

Sincronizarea fișierelor

syncFiles păstrează pe ofertă doar fișierele transmise în lista FILE_IDS. Operația este utilă când sistemul sursă este considerat sursa finală de adevăr pentru galeria ofertei.

Folosește syncFiles cu atenție: fișierele care nu apar în lista transmisă pot fi eliminate din galeria ofertei.

Sincronizarea canalului

syncChannel declanșează sincronizarea canalului pentru oferta indicată. Folosește operația după modificări care trebuie propagate explicit către canalul de publicare.

Retrimiterea datelor

Pentru o sincronizare stabilă, retrimiterile trebuie să păstreze aceiași identificatori:

• același ID_LOCAL pentru ofertă;
• același FILE_ID pentru același fișier;
• aceeași valoare AGENTIA pentru agenția autorizată.

Dacă identificatorii se schimbă, API-ul poate interpreta datele ca entități noi, nu ca actualizări.

Pentru operațiile disponibile, vezi Operații API. Pentru formatul fișierelor, vezi Fișiere media.