Fotografie
Práce s fotkami reflektuje různé systémy, takže možnosti práce s nimi jsou velmi variabilní.
Fotografie podporují pouze JPEG formát
Na úrovni inzerátu
Zasíláte-li na úrovni inzerátu strukturu photos dochází automaticky ke zpracování fotografií tak, že se u inzerátu aktualizují fotky, aby obsahovaly pouze fotografie v této struktuře (smaže staré, přidá nové).
Aktualizace fotky je možné řídit parametrem stamp - uvedete vlastní parametr, který, když se změní, dojde i při stejné URL k aktualizaci fotky. Pokud se Vám při změně fotky mění i URL, není nutné stamp využívat. Pokud jej využíváte, doporučujme uvádět např. datetime, filesize, hash souboru apod.
Na úrovni inzerátu jsou pro photos i dva možné atributy:
ignoreimport="true"- strukturaphotosse ignorujeforceupdate="true"- vynutí aktualizaci všech fotografií bez ohledu na změnu URL čistamp
Pomocí agend photo
Pomocí agendy photo je možné přidávat/editovat/mazat po vždy po jedné fotografii.
Uvádění ID fotografie u inzerátu není povinné - čtěte však chování u jednotlivých možností!
1. Přidání/editace fotografií pomocí url
Pokud uvádíte tag url, je chování následující:
- Je-li uvedeno ID fotografie, pak se kontroluje, zda-li je u této fotografie stejná
url,stampa případně dojde pouze k aktualizaci dané fotografie. - Není-li uvedeno ID fotografie, pak se kontroluje, zda-li existuje u tohoto inzerátu stejná
urla případně se dlestampčiforceupdateaktualizuje tento obrázek. Není-li adresa nalezena, založí se nový obrázek
2. Přidání/editace fotografií pomocí content
Pokud uvádíte tag content, je chování následující:
- Je-li uvedeno ID fotografie, pak se vždy přepíše obsahem fotografie uvedeným v
content - Není-li uvedeno ID fotografie, vždy se založí nový obrázek
3. Přidání/editace fotografií pomocí content
Místo XML struktury můžete zaslat v PUT požadavku přímo JPG data, je však nutné uvést URL parametr ?raw-data=true
- Je-li uvedeno ID fotografie, pak se vždy přepíše obsahem RAW-DATA
- Není-li uvedeno ID fotografie, vždy se založí nový obrázek
Doporučení: Vzhledem k tomu, že založení/přidání fotografie záleží na kontextu dat, není vracena hlavička Location:, avšak vrací se vždy struktura, kde je uvedeno ID fotografie, která byla změněna/vložena.
Smazání fotografie
Je možné buď posláním HTTP operace DELETE nebo zasláním PUT/POST operace s tagem <photo action="delete">
