Pikaopas

Viisi vaihetta tokenista ensimmäiseen julkaistuun ilmoitukseen. Kutsujen tarkat parametrit löytyvät rajapintaviitteestä.

Kokeile turvallisesti

Luonnos ja esikatselussa oleva ilmoitus eivät näy ostajille. Kokeile kutsuja niillä ja poista ilmoitus lopuksi kutsulla DELETE.

Ennen aloitusta

Integraatio toimii Huuto.net-käyttäjätunnuksen nimissä. Tarkista tililtä:

1. Tunnus on luotu osoitteessa www.huuto.net/rekisteroidy ja sähköposti on vahvistettu.
2. Omissa tiedoissa on nimi, puhelinnumero ja osoite. Muuten ilmoituksen luonti palauttaa 400.
3. Olet tunnistautunut osoitteessa www.huuto.net/tunnistautuminen. Ilman tunnistautumista ilmoitusta ei voi julkaista.

1. Kirjaudu

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

Ota vastauksesta talteen authentication.token.id ja käyttäjä-id linkin links.user lopusta. Lähetä token jatkossa otsakkeessa X-HuutoApiToken.

Vinkki

Token on voimassa tunnin luomisesta. Katso Kirjautuminen.

2. Luo ilmoitus

curl -X POST https://api.huuto.net/1.1/items \
  -H 'X-HuutoApiToken: <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Taru Sormusten herrasta -elokuvatrilogia",
    "description": "<p>Kaikki kolme elokuvaa, levyt hyvässä kunnossa.</p>",
    "categoryId": 847,
    "condition": "good",
    "saleMethod": "buy-now",
    "buyNowPrice": 24.90,
    "quantity": 1,
    "openDays": 30,
    "postalCode": "00100",
    "deliveryMethods": ["shipment", "pickup"]
  }'

Vastaus on 201 ja koko ilmoitus. Ota talteen id. Ilmoitus on nyt tilassa preview.

3. Lisää kuva

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

Kuvat lisätään ennen julkaisua. Katso Kuvat.

4. Julkaise

curl -X PUT https://api.huuto.net/1.1/items/<ID> \
  -H 'X-HuutoApiToken: <TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"status": "published"}'

Ilmoitus on nyt myynnissä tilassa open.

Huomio

Julkaisun jälkeen hintaa ja muita tietoja ei voi muuttaa, vain määrää. Katso Saldo ja hinta.

5. Seuraa myyntejä

curl -H 'X-HuutoApiToken: <TOKEN>' \
  'https://api.huuto.net/1.1/users/<USER_ID>/sales?status=closed&sold=1'

Saat myydyt ilmoitukset. Hae niistä ostaja ja toimitustiedot. Koko kulku on ohjeessa Myynnin seuranta.

Apua

Kysymykset rajapinnasta asiakaspalveluun yhteydenottolomakkeella.