Photos

Sans photo, pas de publication

Trois photos au minimum. C’est le blocage le plus fréquent de toute l’intégration, et il n’a rien d’arbitraire : une annonce sans photo ne se vend pas. Nous préférons qu’elle reste en brouillon plutôt que de remplir le catalogue d’annonces que personne ne réservera.

Envoyer des photos

Elles se poussent avec le logement, par URL :

{
  "external_property_id": "PROP-4821",
  "title": "Studio vue mer",
  "photos": [
    { "url": "https://cdn.exemple.com/4821/salon.jpg",   "position": 0, "caption": "Le salon" },
    { "url": "https://cdn.exemple.com/4821/chambre.jpg", "position": 1 },
    { "url": "https://cdn.exemple.com/4821/cuisine.jpg", "position": 2 }
  ]
}

• position fixe l’ordre. La position 0 est la photo de couverture, celle qui apparaît dans les résultats de recherche.
• caption est facultative et s’affiche sous la photo.
• Les URL doivent être accessibles publiquement, en HTTPS, le temps que nous les récupérions.

Ce que nous faisons de vos URL

Nous rapatrions chaque image et la servons depuis notre propre stockage. Vos URL peuvent donc expirer ensuite sans que l’annonce en souffre.

Une image déjà récupérée n’est pas retéléchargée. Renvoyer la même liste à chaque synchronisation ne coûte donc rien, ni à vous ni à nous : c’est le comportement attendu.

Modifier ou retirer

La liste que vous envoyez remplace la précédente. Pour retirer une photo, renvoyez la liste sans elle. Pour réordonner, renvoyez-la avec d’autres position.

Formats

JPEG, PNG et WebP. Visez au moins 1200 pixels de large : en dessous, la photo est floue sur les écrans récents, et elle dessert le logement plus qu’elle ne le sert.