Osastot

Osastopuun rakenne ja suodattimet on selitetty ohjeessa Osastot ja suodattimet.

Listaa pääosastot

GET/1.1/categories

Parametri	Tyyppi	Kuvaus
max-depth	int	1 oletuksena. 2 tai 3 palauttaa alatasot sisäkkäisinä subcategories-taulukoina. Muut arvot tulkitaan 1:ksi.

Listaa alaosastot

GET/1.1/categories/{id}/subcategories

{
  "id": 845,
  "title": "Huuto.net categories",
  "updated": "2026-10-26T15:10:00+0200",
  "links": {
    "self": "https://api.huuto.net/1.1/categories",
    "items": "https://api.huuto.net/1.1/categories/845/items"
  },
  "categories": [
    {
      "id": 847,
      "title": "Blu-ray - Muut",
      "links": {
        "self": "https://api.huuto.net/1.1/categories/847",
        "subcategories": "https://api.huuto.net/1.1/categories/847/subcategories",
        "items": "https://api.huuto.net/1.1/categories/847/items"
      }
    }
  ]
}

max-depth ei vaikuta tähän kutsuun.

Hae osasto

GET/1.1/categories/{id}

Osaston nimi ja linkit. links.items sisältää linkit open, closed, closing, recent ja gallery. links.subcategories on null alimman tason osastossa.

Osaston ilmoitukset

GET/1.1/categories/{id}/items

Osaston avoimet ilmoitukset. Muodot /closed, /closing ja /recent osoitteen lopussa palauttavat suljetut, pian päättyvät ja uusimmat.