Muutokset

26.10.2026: uusi dokumentaatio

Dokumentaatio kirjoitettiin uudelleen ja siirrettiin suomeksi. Rajapinnan osoite ja versio 1.1 eivät muuttuneet. Vuoden 2015 dokumentaatioon verrattuna dokumentoitiin:

• Julkaisu vaatii myyjän tunnistautumisen, virhekoodi IDENTIFICATION_REQUIRED.
• Huutoturva-ilmoitukset: isHuutoturva, hturPackageCode, packageWeight ja toimitustapa seller-delivers.
• Avoimen ilmoituksen määrän päivitys {"quantity": n}.
• Suodattimet kentässä filters.
• Osoitekortti Huutoturva-kaupoille.
• Myyntiaika 1–120 päivää Osta heti -ilmoituksille yritys-, kauppa-, HuutoPlus- ja PowerSeller-tileillä.
• Kuvia enintään 10 ilmoitusta kohden, muodot JPEG, PNG ja GIF.

Korjauksia vanhaan dokumentaatioon:

• Omien ostojen lista haetaan kutsulla GET /1.1/users/{id}/purchases, ei POST-kutsulla.
• Myyntilistan lajittelu hinnan mukaan on sort=price.
• Kirjautumiskutsu lukee tunnuksen ja salasanan lomakemuotoisena, ei JSON-rungosta.

23.10.2015: versio 1.1

Osoite: https://api.huuto.net/1.1/

Ilmoituksen luonti, POST /1.1/items

• Kentät mainCategoryId, sectionCategoryId ja subCategoryId poistettiin. Niiden sijaan annetaan categoryId, joka on osastopuun kolmas eli alin taso.
• Kunto none poistettiin kentän condition arvoista.
• Toimitustavat ovat pickup eli nouto ja shipment eli toimitus. Arvot itella, matkahuolto, fetch, huutopaketti ja other poistettiin.
• Kenttä termsOfDelivery nimettiin uudelleen: deliveryTerms.
• Maksutavat ovat wire-transfer eli tilisiirto ja cash eli käteinen. Arvot credit-transfer, cash-on-delivery ja Payson-vaihtoehdot poistettiin.
• Uusi kenttä paymentTerms maksuehdoille, enintään 1000 merkkiä.
• Kenttää location ei voi enää lähettää. Sen sijaan postalCode on oletuksena pakollinen, ja paikkakunta päätellään postinumerosta.
• Uusi kenttä isLocationAbroad, arvo 0 tai 1. Kun arvo on 1, postinumeroa ei tarvita ja sijainniksi tulee Ulkomaat.
• Myyntitapa hybrid poistettiin. Sallitut arvot ovat auction ja buy-now.
• Kenttä taxPercentage nimettiin uudelleen: vat.
• Kenttä minimumPrice eli hintavaraus poistettiin.
• Uusi kenttä originalId suljetun ilmoituksen uudelleenlistaukseen. Tiedot kopioidaan uuteen luonnokseen, joka julkaistaan siirtämällä se ensin tilaan preview ja sitten tilaan published.

Ilmoituksen muokkaus, PUT /1.1/items/{id}

Yllä olevat muutokset koskevat myös muokkausta, paitsi originalId.

Ilmoituksen tiedot, GET /1.1/items/{id}

• termsOfDelivery on nyt deliveryTerms.
• Uusi kenttä paymentTerms.
• taxPercentage on nyt vat.
• Olio subCategory on nyt category.