Update dat
Posíláte-li požadavek na editaci inzerátu (update dat), v některých případech může být žádoucí, že nechcete, aby došlo ke změně dané položky, jak je na TipMoto.com.
Například někteří klienti si sami upravují např. položku nazev
, zatímco u ostatních částí chtějí, ať dochází k aktualizaci.
Uvádění položky v datech
Vstupní data se v rámci API zpracovávají následujícím způsobem:
Je-li položka v datech uvedena, pak se nastaví dle aktuální hodnoty. Tj. je-li položka prázdná, vymaže se současná hodnota.
Není-li položka v datech uvedena, pak nedochází k žádnému zpracování dat a nedojde vůbec k editaci dané položky.
I z tohoto důvodu nedoporučujeme zbytečně uvádět v rámci zápisu pouze prázdné elementy, pokud je Váš systém vůbec nemá vyplněny.
ignoreonupdate
Abyste nemuseli řešit v rámci aplikace logiku, že pro vložení inzerátu položku vyplníte a pro editaci nebude obsažena, lze k elementu přidat attribut ignoreonupdate="true"
.
V tomto případě se položka pouze zanese při vložení, následně je v rámci zápisů přes API nebude ignorována a klient ji může nastavovat ručně v administraci.
Příklady užití:
XML:
<nazev ignoreonupdate="true">CRF 1100 L Africa Twin</nazev>JSON:
... "nazev": "CRF 1100 L Africa Twin", "nazev@ignoreonupdate": "true", ...