Kuvat

Kuvia voi lisätä ja poistaa vain ilmoitukselle, joka on tilassa draft tai preview. Ensimmäinen kuva on pääkuva, ja uusi kuva lisätään viimeiseksi.

Lisää kuva

POST/1.1/items/{id}/imagesVaatii tokenin

Runko on multipart/form-data, ja yhdessä kutsussa lähetetään yksi kuva.

Parametri	Tyyppi	Pakollinen	Kuvaus
image	tiedosto	kyllä	JPEG, PNG tai GIF, enintään 8 Mt

curl -F 'image=@kuva.jpg' \
  -H 'X-HuutoApiToken: <TOKEN>' \
  https://api.huuto.net/1.1/items/<ID>/images

{ "links": { "image": "https://api.huuto.net/1.1/items/322184647/images/12345678" } }

Tila	Syy
201	Kuva lisättiin
400	Kuva puuttuu, on yli 8 Mt tai ei ole JPEG, PNG tai GIF
400	Kuvia on jo 10, ilmoitus ei ole sinun, tai ilmoitus ei ole luonnos- tai esikatselutilassa
403	Token puuttuu
404	Ilmoitusta ei löydy

Hae kuvat

GET/1.1/items/{id}/imagesToken valinnainen

Luonnoksen ja esikatselun kuvat näkyvät vain myyjälle.

{
  "images": [
    {
      "links": {
        "self": "https://api.huuto.net/1.1/items/123456789/images/261894141",
        "thumbnail": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-s.jpg",
        "medium": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-m.jpg",
        "original": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-orig.jpg"
      }
    }
  ],
  "links": { "self": "https://api.huuto.net/1.1/items/123456789/images" },
  "updated": "2026-10-26T15:10:00+0200"
}

Hae kuva

GET/1.1/items/{id}/images/{imageId}

{
  "links": {
    "self": "https://api.huuto.net/1.1/items/123456789/images/261894141",
    "thumbnail": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-s.jpg",
    "medium": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-m.jpg",
    "original": "https://images.huuto.net/v1/0a1b/eea869a811b177cf79b20f70d876c/261894141-orig.jpg"
  },
  "updated": "2026-10-26T15:10:00+0200"
}

Tuntematon kuva palauttaa 404.

Poista kuva

DELETE/1.1/items/{id}/images/{imageId}Vaatii tokenin

Vastaus on 204.

Tila	Syy
400	Kuva ei kuulu ilmoitukseen, ilmoitus ei ole sinun, tai ilmoitus on väärässä tilassa
403	Token puuttuu
404	Ilmoitusta ei löydy