Image rights on listings

Changes to the API since 041.

Added

You can now manage the image right (bildrättigheter) of a listing. The image right captures who took the photos (the photographer and/or photo agency) and the terms governing for how long Hemnet may show the listing's images after it has been sold.

Three new endpoints are available under a listing:

• GET /listings/{listing_id}/image_right — fetch the listing's image right.
• PUT /listings/{listing_id}/image_right — create or update the listing's image right. Send the fields you want to set or change; any field you omit keeps its current value.
• DELETE /listings/{listing_id}/image_right — delete the listing's image right.

There is at most one image right per listing, so it is addressed directly by the listing in the URL and the PUT acts as an idempotent create-or-update.

The terms field accepts NO_LICENSE, SIX_MONTHS_LICENSE, or INDEFINITE_LICENSE. The photoAgency field accepts one of the predefined agencies (HF_AGENCY, DIAKRIT, SE360, PERFECT_SHOT), FREELANCE for a freelance photographer (provide the name in photoAgencyName), or OWNER_TAKEN when the seller took the photos themselves.

Note that some photo agencies have their own contract with Hemnet, and this might mean that the terms attribute that the broker/your system is sending us is overridden by the one between Hemnet and the respective agency. Hemnet may or may not show the full image right attribution on each listing ad.