Documentazione XML per sviluppatori
Il tracciato Wimmo per importare immobili e gallerie fotografiche.
Specifiche immagini
Queste regole valgono per le gallerie degli annunci residenziali, commerciali e dei terreni. Il nodo <galleria> è facoltativo e, se presente, deve avere modalita="replace". Può essere vuoto oppure contenere fino a 50 immagini per annuncio.
<galleria modalita="replace">
<immagine id_esterno="FOTO-1001" versione="1">
<url>https://esempio.it/immobili/foto-1001.jpg</url>
<descrizione>Soggiorno</descrizione>
<principale>1</principale>
<ordinamento>1</ordinamento>
<stato>1</stato>
<planimetria>0</planimetria>
</immagine>
</galleria>Requisiti del file raggiungibile via URL
| Requisito | Specifica |
|---|---|
| Obbligatorio · URL | Indirizzo HTTPS completo, stabile, raggiungibile senza login e diretto al file. Evitare URL temporanei che scadono prima della lavorazione. |
| Obbligatorio · Formato | Solo .jpg (JPEG) o .png (PNG). Il contenuto reale deve corrispondere al formato dichiarato. |
| Obbligatorio · Dimensione | Massimo 1 MB per immagine, pari a 1.048.576 byte. |
| Dimensioni e proporzioni | Nessun rapporto o dimensione fissa per il file originale: sono accettate immagini quadrate o rettangolari. L’elaborazione finale, come nella galleria CP, le normalizza in un JPG quadrato di 1200 × 1200 px. |
Al caricamento dell’XML vengono controllati la sintassi e il protocollo HTTPS dell’URL, ma le immagini non vengono ancora scaricate. La procedura schedulata dovrà verificare disponibilità, formato reale e dimensione prima di acquisirle e normalizzarle.
Attributi e campi di <immagine>
| Campo | Significato e formato | Obbligatorietà |
|---|---|---|
id_esterno (attributo) | Identificativo stabile della foto presso la fonte, unico nella galleria. | Obbligatorio |
versione (attributo) | Versione stabile per riconoscere un file fotografico aggiornato. | Obbligatorio |
url | URL HTTPS completo del file JPG o PNG conforme ai requisiti sopra indicati. | Obbligatorio |
descrizione | Didascalia dell’immagine. | Facoltativo |
principale | Flag 0 o 1. Se la galleria non è vuota, esattamente una immagine deve avere valore 1. | Obbligatorio |
ordinamento | Intero positivo. | Obbligatorio |
stato | Flag 0 o 1. | Obbligatorio |
planimetria | Flag 0 o 1. | Obbligatorio |
Vuoi scoprire le funzionalità di Wimmo Business?
Scopri tutti i piani e confronta le funzionalità della piattaforma, scegli il piano più idoneo.