Categorieverwijzingen

Deze alleen-lezen endpoints geven de bestaande itemcategorieën van het veilinghuis terug. Ze vereisen categories.read.

Paden zijn relatief aan /api/v2. Alle resultaten horen bij het veilinghuis van de API-sleutel.

{
  "id": "cat_b48e0a19-5c72-4d83-91af-3e6b2c07d514",
  "name": "Zilver",
  "slug": "zilver",
  "parent": null,
  "created_at": "2026-05-20T14:02:00Z",
  "updated_at": "2026-07-05T19:08:11Z"
}

name gebruikt de standaardtaal van het veilinghuis; een ontbrekende vertaling geeft null. parent is de publieke ID van een bovenliggende categorie of null. Een bovenliggende categorie van een ander veilinghuis wordt nooit getoond.

Zoeken op slug

Vraag /api/v2/categories?slug=zilver op. De overeenkomst is exact en hoofdlettergevoelig; waarden worden niet getrimd. Lege strings, strings met uitsluitend witruimte, NUL-bytes, arrays en objecten worden geweigerd.

Slugs zijn niet uniek. Volg de paginering door alle overeenkomsten en beoordeel dubbele resultaten expliciet. Beide endpoints gebruiken de standaard data-envelop. De lijst ondersteunt ook limit en cursor; cursors horen bij het oorspronkelijke veilinghuis en de oorspronkelijke filters. Het detailendpoint weigert lijstfilters en beide endpoints ondersteunen geen expansies.

Een record zonder geldige publieke identiteit geeft een 500 Problem Details-antwoord. Leesverzoeken herstellen geen opgeslagen identiteiten. Categorieën aanmaken en aan items koppelen volgt in later API-werk; het bredere taxonomieplan beschrijft die richting.