Kirjautuminen

Kirjaudu

POST/1.1/authentication

Palauttaa tokenin, jota käytetään otsakkeessa X-HuutoApiToken. Runko on lomakemuotoinen, JSON-runkoa ei lueta.

Parametri	Tyyppi	Pakollinen	Kuvaus
username	string	kyllä	Huuto.net-käyttäjätunnus
password	string	kyllä	Salasana

curl -X POST https://api.huuto.net/1.1/authentication \
  --data-urlencode 'username=kauppa123' \
  --data-urlencode 'password=salasana'

{
  "authentication": {
    "token": {
      "id": "1e0bb382298a103578b2801527b4dbca",
      "startTime": "2026-10-26T14:04:59+0200",
      "expires": "2026-10-26T15:04:59+0200"
    }
  },
  "links": {
    "self": "https://api.huuto.net/1.1/authentication",
    "user": "https://api.huuto.net/1.1/users/966898"
  },
  "updated": "2026-10-26T14:04:59+0200"
}

Linkin links.user lopussa on käyttäjä-id, jota tarvitaan esimerkiksi myyntilistassa. Tarkista lisäksi, ettei authentication.token ole null.

Tila	Syy
201	Token luotiin
400	Väärä tunnus tai salasana, vahvistamaton sähköposti, salasana pitää vaihtaa, tili on suljettu tai poistettu käytöstä, tai IP-osoite on estetty

Tokenin voimassaolo

Token on voimassa tunnin luomisesta, eikä käyttö pidennä sitä. Sama tunnus ja salasana voivat 30 minuutin sisällä palauttaa saman tokenin. Lue vanhenemisaika aina kentästä expires ja kirjaudu uudelleen ennen sitä.

Vinkki

Säilytä salasana palvelimen salaisuuksissa tai ympäristömuuttujassa, älä lähdekoodissa.

Kirjaudu ulos

DELETE/1.1/authenticationVaatii tokenin

Mitätöi tokenin. Vastaus on 204.