api.tipmoto.com » Dokumentace API » Příklady » Změna pořadí fotek

Příklad změny pořadí fotek

Pořadí fotek inzerátu a hlavní fotku můžete změnit třemi způsoby. Pravidla jsou pro všechny stejná, viz Pořadí a hlavní fotka.

1. Více fotek najednou: podagenda photo/sort

Načtěte fotky inzerátu:

GET https://api.tipmoto.com/c/{ID firmy}/moto/{ID inzerátu}/photo.xml

Ve výpisu je u každé fotky id a sortOrder (pozice, 1 = hlavní fotka). Fotky seřaďte, jak potřebujete, a pošlete je v photos – stačí id:

PUT https://api.tipmoto.com/c/{ID firmy}/moto/{ID inzerátu}/photo/sort.xml

<tipmoto>
  <photos>
    <!-- první položka bude hlavní fotka -->
    <photo><id>11</id></photo>
    <photo><id>2</id></photo>
    <photo><id>3</id></photo>
    <!-- fotky, které v seznamu nejsou, přijdou za ně v dosavadním pořadí -->
  </photos>
</tipmoto>

Totéž v JSON (PUT na …/photo/sort.json):

{
    "tipmoto": {
        "photos": {
            "photo": [
                {"id": "11"},
                {"id": "2"},
                {"id": "3"}
            ]
        }
    }
}

Výsledek si můžete nejdřív vyzkoušet s parametrem ?dry-run=true – nic se neuloží a odpověď ukáže výsledné pořadí. Poslat můžete i celý přeřazený výpis photo.xml (fotky obalené do photos); ostatní prvky se ignorují, jen prvky sortOrder je nutné vynechat. Podrobnosti popisuje podagenda photo/sort.

2. Jedna fotka: PUT /photo/{id}

Fotku 7 přesunete na pozici 2 (hlavní fotka zůstane):

PUT https://api.tipmoto.com/c/{ID firmy}/moto/{ID inzerátu}/photo/7.xml

<tipmoto>
  <photo>
    <sortOrder>2</sortOrder>
  </photo>
</tipmoto>

Fotku 7 nastavíte jako hlavní (přesune se na pozici 1, ostatní fotky si drží vzájemné pořadí):

<tipmoto>
  <photo>
    <main>1</main>
  </photo>
</tipmoto>

3. V importu inzerátu: photos

Při importu celého inzerátu (příklad) se pořadím hýbe jen na výslovné vyžádání: main = 1 nebo sortOrder u fotky, případně atribut reorder="true", se kterým se galerie seřadí podle pořadí fotek v photos:

<photos reorder="true">
  <photo><url>https://www.webprodejce.cz/ph/AB-198_3.jpg</url></photo>
  <photo><url>https://www.webprodejce.cz/ph/AB-198_1.jpg</url></photo>
  <photo><url>https://www.webprodejce.cz/ph/AB-198_2.jpg</url></photo>
</photos>

Bez reorder, main a sortOrder import pořadí fotek nemění – zůstane i pořadí, které si prodejce nastavil v administraci.

Kontaktujte nás