Fișiere media

Acest capitol explică fluxul pentru imagini și resurse media: verificarea existenței fișierelor, încărcarea prin addFile, formatul conținutului media și sincronizarea listei de fișiere.

Flux recomandat

1. Publică sau actualizează oferta prin saveProperty.
2. Verifică dacă fișierul există deja prin existsFile.
3. Încarcă fișierul lipsă prin addFile.
4. Sincronizează lista finală prin syncFiles, dacă vrei ca oferta să păstreze doar fișierele transmise în FILE_IDS.
5. Declanșează syncChannel când este necesară sincronizarea canalului pentru oferta indicată.

Câmpuri pentru addFile

Pentru addFile, câmpurile fișierului se transmit direct în options, fără structură imbricată:

• AGENTIA - ID-ul agenției autorizate pentru publicare.
• ID_LOCAL - identificatorul intern al ofertei la care se atașează fișierul.
• FILE_ID - identificatorul unic al fișierului.
• FILE_TITLE - titlul sau descrierea fișierului.
• FILE sau FILE_BODY - conținutul fișierului în Base64 brut, generat din conținutul binar.
• FILE_URL - URL-ul sursei fișierului, dacă integrarea îl trimite pe lângă conținutul media.
• ORDER - poziția fișierului în lista media a ofertei.

FILE și FILE_BODY nu acceptă prefixe Data URI precum data:image/jpeg;base64,.

Câmpuri pentru existsFile

Folosește existsFile înainte de addFile ca să eviți reîncărcarea aceleiași imagini:

• AGENTIA - ID-ul agenției.
• ID_LOCAL - identificatorul ofertei.
• FILE_ID - identificatorul stabil al fișierului în sistemul sursă.

Câmpuri pentru syncFiles

După încărcarea imaginilor, trimite lista finală prin syncFiles:

• AGENTIA - ID-ul agenției.
• ID_LOCAL - identificatorul ofertei.
• FILE_IDS - lista fișierelor care trebuie să rămână în galeria ofertei.

syncFiles este o operație de reconciliere: fișierele care nu apar în FILE_IDS pot fi eliminate din galeria ofertei.

Pentru lista operațiilor SOAP asociate, vezi Operații API. Pentru fluxul complet de publicare și sincronizare, vezi Sincronizare.