Show us your compound!

❗️
Photos basics

We highly recommend to have at least 10 photos for a better performance.

To update a photo, please push it with a different url, only then it will be recognized as a new photo and then it will be updated. To do so, you can include a param + the timestamp of when the photo was updated to the URL.

To update or delete photos, please repush the entire list of current photo objects. Photos can be deleted, but only by pushing new photos. An empty list of photos is ignored.

When pushing photos to our photos endpoint, it is important to include a filter to eliminate duplicate URLs. Duplicate URLs within a photo push request will lead to a failure of the entire request. Therefore, ensuring that each URL is unique helps maintain the integrity of the photo push process and prevents potential issues with data ingestion.

Ideally the photos should have a size of 2MB. To make sure everything runs smoothly, they should not be larger than 8MB.

Parameter	Type	Required	Usage
`url`	string	YES	Photo URL Recommendations: ideal resolution 2048x1536 pixels min resolution 1024x683 pixels ideal size: 2MB, no larger than 8MB orientation: landscape formats: JPG, JPEG, PNG no photo duplications
`position`	int32 ≥ 1	YES	Position of the photo to be shown to the potential guest
`contentLength`	int64 ≥ 1	No	File size of the photo in bytes
`localizations`	array of objects	No	Photo titles in different languages
`localizations.language`	string	YES	Language of the photo title
`localizations.title`	string	YES	Title of the photo

PHOTOS JSON object

[
  {
    "url": "https://example.com/photos/pool.jpg",
    "position": 1,
    "contentLength": 2048000,
    "localizations": [
      {
        "language": "en",
        "title": "Outdoor Pool"
      },
      {
        "language": "de",
        "title": "Außenpool"
      },
      {
        "language": "fr",
        "title": "Piscine Extérieure"
      }
    ]
  },
  {
    "url": "https://example.com/photos/gym.jpg",
    "position": 2,
    "contentLength": 3072000,
    "localizations": [
      {
        "language": "en",
        "title": "Fitness Center"
      },
      {
        "language": "de",
        "title": "Fitnesszentrum"
      },
      {
        "language": "fr",
        "title": "Centre de Fitness"
      }
    ]
  }
]