Käyttäjät

Hae käyttäjä

GET/1.1/users/{id}Token valinnainen

Käyttäjän tiedot. Esimerkki on ostajasta, jonka kanssa olet käynyt kauppaa:

{
  "updated": "2026-10-26T15:10:00+0200",
  "links": {
    "self": "https://api.huuto.net/1.1/users/1234567",
    "alternative": "https://www.huuto.net/kayttaja/1234567",
    "feedbacks": "https://api.huuto.net/1.1/users/1234567/feedbacks",
    "settings": null,
    "purchases": null,
    "sales": null
  },
  "id": 1234567,
  "username": "ostaja123",
  "type": "normal",
  "description": null,
  "feedback": 42,
  "address": {
    "fullName": "Teppo Testaaja",
    "email": "teppo.testaaja@example.com",
    "street": "Katuosoite 1",
    "zip": "00100",
    "town": "Helsinki",
    "telephone": null,
    "mobile": "+358501234567",
    "countryCode": "FI",
    "countryName": "…"
  },
  "lastLogin": null,
  "roles": ["authenticated"],
  "companyName": null,
  "companyCode": null
}

Kenttä	Kuvaus
type	normal, company tai shop
feedback	Palautepisteet
address	Näkyy omassa profiilissa ja käyttäjistä, joiden kanssa olet käynyt kauppaa. Muuten null.
lastLogin	Vain omassa profiilissa, muuten null
links.settings, links.purchases, links.sales	Vain omassa profiilissa, muuten null

Osoite

address on käyttäjän profiiliosoite, ja se voi poiketa kaupan toimitusosoitteesta. Jos profiili on haettu ennen kauppaa, osoite voi näkyä vasta tunnin viiveellä.

Omat asetukset

GET/1.1/users/{id}/settingsVaatii tokenin

Kertoo, mitä ilmoituskenttiä tilisi saa käyttää. Jokaisella kentällä on isAllowed ja isRequired, ja rajatuilla kentillä myös min ja max. openDays on jaettu myyntitavoittain.

{
  "item": {
    "quantity": { "isAllowed": true, "isRequired": true, "min": 1, "max": 32767 },
    "openDays": {
      "auction": { "isAllowed": true, "isRequired": false, "min": 1, "max": 60 },
      "hybrid": { "isAllowed": true, "isRequired": false, "min": 1, "max": 60 },
      "buyNow": { "isAllowed": true, "isRequired": false, "min": 1, "max": 120 }
    },
    "republish": { "isAllowed": true, "isRequired": false },
    "image": { "isAllowed": true, "isRequired": false, "min": 0, "max": 10 }
  },
  "updated": "2026-10-26T15:10:00+0200"
}

Esimerkki on lyhennetty yritystilin vastauksesta.

Palautteet

GET/1.1/users/{id}/feedbacks

Käyttäjän saamat palautteet ja niiden yhteenveto.

Omat ostot

GET/1.1/users/{id}/purchasesVaatii tokenin

Parametri	Tyyppi	Kuvaus
status	string	all oletuksena, open, closed tai processing
sort	string	closing-time oletuksena, list-time, bidders tai price
limit	int	50 oletuksena tai 500, muut arvot tulkitaan 50:ksi
page	int	Sivunumero, alkaen 1

Muistilista

GET/1.1/users/{id}/favoritesVaatii tokenin

Parametri	Tyyppi	Kuvaus
status	string	all, open tai closed
limit	int	Tuloksia sivulla
page	int	Sivunumero, alkaen 1

POST/1.1/users/{id}/favoritesVaatii tokenin

Lisää ilmoituksen kentällä itemid, lomakkeena tai JSONina. Vastaus on 201, ja tuntematon ilmoitus palauttaa 403.

DELETE/1.1/users/{id}/favorites/{itemId}Vaatii tokenin

Poistaa ilmoituksen. Vastaus on 204, ja ilmoitus, joka ei ole listalla, palauttaa 403.

Vinkki

Kutsuissa, joiden osoitteessa on oma käyttäjä-id, id:n pitää olla tokenin käyttäjä. Muuten vastaus on 401.