Etiketgegevens opvragen via ISBN

Afnemers kunnen de gegenereerde etiketgegevens van een manifestatie opvragen door te zoeken op ISBN-nummer. De API retourneert de volledige manifestatie inclusief het ZIZO-etiket en het SISO-etiket.

Endpoint


Base URL	`…`
Pad	`GET /entities/{isbn}`

Vervang {isbn} door het ISBN-nummer (ISBN-10 of ISBN-13) van de manifestatie.

Headers

Header	Waarde	Verplicht
`Authorization`	`Bearer {token}`	Ja
`x-tenant-id`	`vlacc`	Ja

Voorbeeld

Request

Vervang {BASE_URL} door de Base URL hierboven.

bash

curl -X GET \
  '{BASE_URL}/entities/9789021489841' \
  -H 'Authorization: Bearer {token}' \
  -H 'x-tenant-id: vlacc'

Response

De response bevat de volledige manifestatie. De etiketvelden zitten in de metadata array:

json

{
  "id": "M-ABC123DEF",
  "identifiers": ["M-ABC123DEF", "9789021489841"],
  "type": "manifestation_word",
  "metadata": [
    { "key": "title", "value": "De ontdekking van de hemel" },
    { "key": "generated_label_zizo_type", "value": "VN ZIZO 2*9" },
    { "key": "generated_label_zizo_z", "value": "VN ZIZO 2*9" },
    { "key": "generated_label_zizo_a", "value": "FILOSOFIE" },
    { "key": "generated_label_zizo_b", "value": "Romans" },
    { "key": "generated_label_zizo_c", "value": "FI" },
    { "key": "generated_label_zizo_f", "value": "MULI" },
    { "key": "generated_label_zizo_jaar", "value": "1992" },
    { "key": "generated_label_zizo_deel", "value": "" },
    { "key": "generated_label_siso_type", "value": "VN SISO" },
    { "key": "generated_label_siso_c", "value": "860.4" },
    { "key": "generated_label_siso_f", "value": "MULI" },
    { "key": "generated_label_siso_jaar", "value": "1992" },
    { "key": "label_generated_at", "value": "2026-04-20T14:30:00+00:00" }
  ]
}

Etiketvelden

Elke manifestatie kan tot twee etiketten hebben: een ZIZO-etiket en een SISO-etiket.

ZIZO-etiket (`generated_label_zizo_*`)

Het classificatie-etiket op basis van het ZIZO-schema (Zoek-Informatie-Zoeksleutel/Orienteringssleutel).

Veld	Beschrijving	Voorbeeld
`generated_label_zizo_type`	Het etikettype	`VN ZIZO 2*9`
`generated_label_zizo_z`	Typecode (zelfde als type)	`VN ZIZO 2*9`
`generated_label_zizo_a`	Onderwerp (HOOFDLETTERS)	`FILOSOFIE`
`generated_label_zizo_b`	Detail/subonderwerp	`Romans`
`generated_label_zizo_c`	ZIZO-categoriecode (2 letters)	`FI`
`generated_label_zizo_f`	Signatuur (4 letters auteur/titel)	`MULI`
`generated_label_zizo_jaar`	Publicatiejaar	`1992`
`generated_label_zizo_deel`	Deelnummer	`3`

SISO-etiket (`generated_label_siso_*`)

Het numerieke classificatie-etiket op basis van de SISO-code.

Veld	Beschrijving	Voorbeeld
`generated_label_siso_type`	Het etikettype	`VN SISO`
`generated_label_siso_c`	SISO-classificatienummer	`860.4`
`generated_label_siso_f`	Signatuur (4 letters auteur/titel)	`MULI`
`generated_label_siso_jaar`	Publicatiejaar	`1992`
`generated_label_siso_deel`	Deelnummer	`3`

Tijdstempel

Veld	Beschrijving
`label_generated_at`	Tijdstip waarop de etiketten zijn gegenereerd (ISO 8601)

Welke manifestaties hebben etiketten?

Niet elke manifestatie krijgt etiketten. De etiketten worden gegenereerd op basis van het materiaaltype en de doelgroep:

Volwassenen non-fictie: ZIZO-etiket + SISO-etiket
Volwassenen fictie (VF): alleen ZIZO-etiket (met fictietype als classificatie)
Jeugd fictie (JF): alleen ZIZO-etiket
Jeugd non-fictie (JN): alleen ZIZO-etiket
Kleuter ZIZO: alleen ZIZO-etiket
Strips (V/J): alleen ZIZO-etiket
DVD's: alleen ZIZO-etiket

Geen etiket wordt gegenereerd voor: bladmuziek, tracks, daisy, artikels en grote letter.

Foutafhandeling

HTTP Status	Betekenis
`200`	Manifestatie gevonden
`404`	Geen manifestatie gevonden voor dit ISBN
`401`	Ongeldige of verlopen authenticatie

Etiketgegevens opvragen via ISBN ​

Endpoint ​

Headers ​

Voorbeeld ​

Request ​

Response ​

Etiketvelden ​

ZIZO-etiket (generated_label_zizo_*) ​

SISO-etiket (generated_label_siso_*) ​

Tijdstempel ​

Welke manifestaties hebben etiketten? ​

Foutafhandeling ​