v3-24.4.2 | Timestamp: 2024-04-29T13:33:55.587327

Structuur van de API

Er is een OpenAPI spec beschikbaar van de API, deze kan geraadpleegd worden via /v3/docs/openapi.

/v3/docs

Deze documentatie

/v3/lerarenkaart/

GET Request met drie specifieke headers:

Respons is altijd Content-type:application/json.

Query parameters

Structuur van de respons.

Dit voorbeeld toont een request voor een actieve kaart, waarbij de gebruiker het recht heeft om op insz te zoeken en om hash, niveau en Lerarenkaartnummer te zien.

De 'insz_hash' waarde in 'detail' zal er ook zijn als er voor een opgegeven insz geen gerechtigde gevonden werd. Dit om in de toekomst opnieuw te kunnen checken zonder het insz te hoeven opslaan.

{
    "authentication": {
        "client_name": "Zorg corp.",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-02-23T08:03:30+01:00",
    "provided": "57251564713",
    "provided_type": "insz",
    "message": "Het opgegeven nummer hoort bij een momenteel actieve Lerarenkaart.",
    "status": 200,
    "quality": "valid",
    "found": {
        "hash": "f79ebf1e7d715ca8",
        "lknr": "26602020028",
        "niveau": "110111"
    },
    "detail" : {
        "insz_hash" : "f79ebf1e7d715ca8"
    }
    "version": "v23.10.1-9-gdc67bbf"
}

Mogelijke waarden van authentication.quality

Mogelijke waarden van quality

Voorbeelden die geen gevonden waarde opleveren (4xx)

De waarde van status zal ook als http response code gezet zijn.

De provided_type key zal alleen aanwezig zijn wanneer de X-Value-Type header een waarde bevat.

Al deze voorbeelden gaan uit van de > 2025 situatie, dus niet van legacy calls.

Verzoek zonder geldige API key

{
    "provided": "24609100060",
    "provided_type" : "lknr",
    "quality": "unauthorized",
    "authentication": {
        "quality": "authfailed",
        "message": "Geen of ongeldige API-key."
    },
    "requested_at": "2021-06-16T12:11:11+0000",
    "status": 401,
    "message": "Deze API is enkel met authorisatie te gebruiken. Check https://www.klasse.be/api voor meer informatie.",
    "version": "v3"
}

Vormelijk fout nr

{
    "provided": "2761119004",
    "provided_type" : "lknr",
    "quality": "value_tooshort",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2021-06-16T11:57:26+0000",
    "status": 400,
    "message": "Het opgegeven nummer is te kort.",
    "version": "v3"
}

De quality kan hier de waarden tooshort, empty of badsyntax hebben.

Vormelijk correct, maar niet bestaand nummer.

{
    "provided": "47810230168",
    "provided_type" : "lknr",
    "quality": "notexist",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2021-06-16T11:59:15+0000",
    "status": 404,
    "message": "Het opgegeven nummer hoort niet bij een gekende Lerarenkaart.",
    "version": "v3"
}

Geldige respons (2xx)

Of een gebruiker found terugkrijgt, en wat er in found zit, hangt af van diens rechten. Enkel voor legacy kaarten (uitgavejaar 2024 of vroeger en lege of onbestaande X-Value-Type) kunnen er een naam en WIML gegevens teruggegeven worden in detail.

Geldig nummer in het huidige uitgavejaar.

{
    "authentication": {
        "client_name": "Zorg corp.",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-02-23T08:03:30+01:00",
    "provided": "57251564713",
    "provided_type": "insz",
    "message": "Het opgegeven nummer hoort bij een momenteel actieve Lerarenkaart.",
    "status": 200,
    "quality": "valid",
    "found": {
        "hash": "f79ebf1e7d715ca8",
        "lknr": "26602020028",
        "niveau": "110111"
    },
    "version": "v23.10.1-9-gdc67bbf"
}

Of deze waarden aanwezig zijn, hangt af van de rechten van de gebruiker. Een gebruiker die enkel het recht kan checken, krijgt geen found.

Voorbeelden van legacy calls op /v3/lerarenkaart

In 2024 zullen calls zonder X-Value-Type header als legacy calls behandeld worden, dus uitgaand van een fysiek aangemaakte kaart. Calls met X-Value-Type header zullen uitgaan van een digitale Lerarenkaart. Vanaf 1 februari 2025 betekent een lege of geen X-Value-Type header hetzelfde als een X-Value-Type van lknr.

Hieronder staan voorbeelden van deze legacy calls.

Lerarenkaart die enkel vorig uitgavejaar bestaat.

{
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2021-06-16T12:02:29+0000",
    "provided": "19604150038",
    "message": "Het opgegeven nummer hoort bij een Lerarenkaart die niet meer actief is.",
    "status": 200,
    "quality": "obsolete",
    "found": {
        "stamnummer": "19604150038",
        "niveau": "000000",
        "lerarenkaartnummer": "19604150038-000000",
        "year": "2021"
    },
    "version": "v3"
}

Lerarenkaart die enkel vorig uitgavejaar bestaat.

{
    "provided": "19604150038",
    "quality": "obsolete",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2021-06-16T12:02:29+0000",
    "found": {
        "stamnummer": "19604150038",
        "niveau": "000000",
        "lerarenkaartnummer": "19604150038-000000",
        "year": "2019",
        "batch": {
            "date": "2019-03-13",
            "nr": "15",
            "name": "Klasse magazine maart 2019",
            "published": true
        }
    },
    "detail": {
        "type": "unavailable",
        "parameters": {
            "support_email": "secretariaat@klasse.be",
            "issue_year": 2020
        },
        "template": "unavailable"
    },
    "status": 200,
    "message": "Het opgegeven nummer hoort bij een Lerarenkaart die niet meer actief is.",
    "version": "v3"
}

Lerarenkaart waarvoor contact moet opgenomen worden met Klasse.

{
    "quality": "valid",
    "status": 200,
    "provided": "23503210033",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2020-03-15T10:52:00+0100",
    "found": {
        "stamnummer": "23503210033",
        "niveau": "100100",
        "lerarenkaartnummer": "23503210033-100100",
        "year": "2020",
        "name": "Kelsy H",
        "batch": {
            "date": "2019-12-16",
            "nr": "18",
            "name": "Klasse magazine december 2019",
            "published": true
        }
    },
    "detail": {
        "type": "klasse",
        "parameters": {
            "support_email": "secretariaat@klasse.be",
            "issue_year": "2020",
            "support_link": "https://www.klasse.be?pagina=abonnement&stamnummer=23503210033",
            "date": "4 januari"
        },
        "template": "klasse"
    },
    "message": "Het opgegeven nummer hoort bij een momenteel actieve Lerarenkaart.",
    "version": "v3"
}

Dit algemene patroon, waarbij in detail (Waar Is Mijn Lerarenkaart) de keys type, parameters en template zijn voorzien, keert algemeen terug bij alle kaarten waar gegevens voor gevonden worden. Binnen parameters variëren de keys naargelang de template key.

Lerarenkaart die bij een abonnement hoort.

{
    "quality": "valid",
    "status": 200,
    "provided": "29201040048",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2020-03-15T10:52:00+0100",
    "found": {
        "stamnummer": "29201040048",
        "niveau": "110010",
        "lerarenkaartnummer": "29201040048-110010",
        "year": "2020",
        "name": "Anneleen D",
        "batch": {
            "date": "2020-03-19",
            "nr": "19",
            "name": "Klasse magazine maart 2020",
            "published": true
        }
    },
    "detail": {
        "type": "abo",
        "parameters": {
            "support_email": "secretariaat@klasse.be",
            "issue_year": "2020",
            "support_link": "https://www.klasse.be?pagina=abonnement&stamnummer=29201040048",
            "magazine": "maart 2020",
            "abo_id": 997047
        },
        "template": "abo"
    },
    "message": "Het opgegeven nummer hoort bij een momenteel actieve Lerarenkaart.",
    "version": "v3"
}

Hierbij is het ID van het abonnement als extra waarde (abo_id) toegevoegd aan wiml.

Lerarenkaart die bij een afhaalpunt moet opgehaald worden.

{
    "quality": "valid",
    "status": 200,
    "provided": "19308070066",
    "authentication": {
        "client_name": "Mijn Onderwijs",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2020-03-15T10:52:00+0100",
    "found": {
        "stamnummer": "19308070066",
        "niveau": "001111",
        "lerarenkaartnummer": "19308070066-001111",
        "year": "2020",
        "name": "Saskia V".
        "batch": {
            "date": "2019-12-16",
            "nr": "18",
            "name": "Klasse magazine december 2019",
            "published": true
        }
    },
    "detail": {
        "type": "ap",
        "parameters": {
            "support_email": "secretariaat@klasse.be",
            "notices": [
                {
                    "level": "notice",
                    "message": "Leraren die in de deelgemeenten Kozen wonen kunnen hun Lerarenkaart in de plaatselijke bibliotheek afhalen."
                }
            ],
            "issue_year": "2020",
            "support_link": "https://www.klasse.be?pagina=abonnement&stamnummer=19308070066",
            "start_date": "23 december",
            "end_date": "10 juli",
            "past": false,
            "collectionpoint": {
                "id": 201,
                "name": "OPENBARE BIBLIOTHEEK NIEUWERKERKEN/KOZEN",
                "type": "ap",
                "website": "https://www.sint-truiden.be/bibliotheek-toni-coppers",
                "address": [
                    "Pastorijstraat /Opcozenstraat  7",
                    "3850 Nieuwerkerken/Kozen"
                ],
                "map": "https://www.google.be/maps/place/Pastorijstraat+%2FOpcozenstraat++7%2C3850+Nieuwerkerken%2FKozen"
            }
        },
        "template": "ap"
    },
    "message": "Het opgegeven nummer hoort bij een momenteel actieve Lerarenkaart.",
    "version": "v3"
}

Het veld notices (in parameters) is niet altijd aanwezig, enkel indien er een te tonen bijzonder bericht is ivm de WIML-status. Het level van een notice is nu altijd notice, dit kan in de toekomst evt uitgebreid worden met extra levels.

/v3/templates

Een overzicht van de beschikbare output-templates die de data in de parameters key van de individuele responses gebruiken, om deze info te tonen aan (mogelijke) Lerarenkaart-gerechtigden.

/v3/voordelen/voordeel/[id]

Ophalen van individuele voordelen of voordelen in bulk.

GET Request met deze specifieke header:

Respons is altijd Content-type:application/json.

URL parameters

Query parameters

De query parameters worden genegeerd als de id url parameter wordt meegegeven.

Structuur van de respons.

Enkel voordeel

Request: /v3/voordelen/192338

{
    "authentication": {
        "client_name": "View_Voordeel",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-03-29T13:29:47+00:00",
    "message": "Er bestaat een voordeel met het opgegeven voordeel_id.",
    "status": 200,
    "quality": "valid",
    "found": {
        "categories": [
            {
                "slug": "cultuur-en-geschiedenis",
                "name": "Cultuur en Geschiedenis"
            }
        ],
        "contactinfo": {
            "phone": "0489 41 00 48",
            "email": "eef-nelissen-192330@example.com",
            "website": "http://www.fortdeloncin.be",
            "facebook": "https://www.facebook.com/FSFL.ASBL",
            "twitter": "",
            "instagram": ""
        },
        "description": "<p>Op 15 augustus 1914 (WO I) sloeg een obus van een Duitse Dikke Bertha in op het kruitmagazijn van het Fort van Loncin (nabij Luik). 350 soldaten lieten daarbij het leven, 250 soldaten liggen nog steeds begraven onder het puin. Ontdek het domein en herbeleef dit drama op de originele site.</p>",
        "discount": {
            "description": "<p><strong>Gratis</strong> met je Lerarenkaart in plaats van 2 euro.</p>",
            "requires_teacher_card": 0,
            "url": "",
            "code": "",
            "conditions": ""
        },
        "educational_contactinfo": {
            "name": "Jean-Paul Broos",
            "phone": "0489 41 00 48",
            "email": "hugo-baele-192338@example.com"
        },
        "featured_image": 539541,
        "id": "192338",
        "images": [
            {
                "url": "https://www.klasse.be/wp/wp-content/uploads/2019/09/fortdeloncin.jpg",
                "alt": "Buitenzicht op het Fort de Loncin",
                "caption": "",
                "id": 539541,
                "copyright_text": "Fort de Loncin",
                "copyright_url": ""
            },
            {
                "url": "https://www.klasse.be/wp/wp-content/uploads/2019/09/fortdeloncin1.jpg",
                "alt": "Soldaten aan een tafel in Fort de Loncin",
                "caption": "",
                "id": 539543,
                "copyright_text": "Fort de Loncin",
                "copyright_url": ""
            },
            {
                "url": "https://www.klasse.be/wp/wp-content/uploads/2019/09/fortdeloncin2.jpg",
                "alt": "",
                "caption": "",
                "id": 539544,
                "copyright_text": "Fort de Loncin",
                "copyright_url": ""
            }
        ],
        "is_teacher_day": 0,
        "locations": [
            {
                "name": "Fort de Loncin",
                "street": "Rue des Héros 15",
                "zipcode": "4431",
                "city": "Ans",
                "province": "Liège",
                "country": "België",
                "latitude": "50.67451",
                "longitude": "5.492424"
            }
        ],
        "main_category": "cultuur-en-geschiedenis|museum-en-expo",
        "modified_date": "2022-07-28 18:48:04",
        "periods": [],
        "provider": {
            "id": "192330",
            "name": "Fort van Loncin"
        },
        "publish_date": "2019-09-27 16:55:55",
        "related_benefit_ids": [
            43316,
            43060,
            46217,
            708221,
            707367
        ],
        "school_program": {
            "target_audience": {
                "min_age": 10,
                "max_age": 0
            },
            "description": "<h2>Programma voor je klas</h2><h3>Omschrijving</h3><p>Er zijn rondleidingen met een Nederlandstalige gids. Je betaalt hiervoor 2 euro per leerling, begeleiders krijgen gratis toegang. Niet-schoolgroepen (vanaf 10 personen) betalen 5 euro per persoon voor een begeleid bezoek.</p><p>Er is bovendien een <a href=\"https://be.klasse.www/wp/wp-content/uploads/2019/09/Lespakket-Fort-van-Loncin.docx\">gratis downloadbare lesbrief</a> om je bezoek voor te bereiden.</p><p>Met de gids bezoek je het museum (over de eerste wereldoorlog en het Fort van Loncin) en daarna het Fort zelf. Naast de geschiedenis over het Fort en uitleg over het leven in het Fort bekijk je de krater en klim je naar het top van het Fort voor een blik op de omgeving en de verwoeste kanonnen.</p><p>Je bezoekt daarna de crypte waar de soldaten rusten die door DOVO werden teruggevonden. Ten slotte neem je nog een kijkje in een klein extra museum over het RAF-vliegtuig dat in 1943 aan het fort neerstortte.</p>"
        },
        "service_ids": [],
        "status": "publish",
        "subcategories": [
            {
                "slug": "cultuur-en-geschiedenis|museum-en-expo",
                "name": "Museum en Expo"
            }
        ],
        "subject_ids": [
            298
        ],
        "summary": "",
        "tags": [
            31052
        ],
        "title": "Fort de Loncin",
        "type": "Educatief voordeel",
        "unpublish_date": "",
        "website_url": "https://www.klasse.be/voordelen-aanbod/ans-fort-de-loncin-lerarenkaart/"
    },
    "version": "v3-24.3.1"
}

Meerdere voordelen

Request: /v3/voordelen/?modified_since=2024-01-01T00:00:00&per_page=3

{
    "authentication": {
        "client_name": "View_Voordeel",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-03-29T13:22:27+00:00",
    "params": {
        "per_page": 3
    },
    "message": "Lijst van voordelen wordt getoond.",
    "status": 200,
    "quality": "list_valid",
    "found": {
        "page": 1,
        "per_page": 3,
        "total": 838,
        "body": [
           ...
        ]
    },
    "version": "v3-24.3.1"
}

De body van found bevat per voordeel de volledige structuur zoals opgeslagen.

/v3/voordelen/taxonomies/[taxonomy]

Ophalen van individuele taxonomy of alle taxonomies.

GET Request met deze specifieke header:

Respons is altijd Content-type:application/json.

URL parameters

Structuur van de respons.

Alle taxonomies

Request: /v3/voordelen/taxonomies

{
    "authentication": {
        "client_name": "View_Voordeel",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-04-12T09:51:06+00:00",
    "message": "Geldig verzoek.",
    "status": 200,
    "quality": "valid",
    "found": {
        "tags": [
            {
                "id": 31000,
                "name": "Pretpark",
                "slug": "pretpark"
            },
            {
                "id": 31001,
                "name": "Dierenpark",
                "slug": "dierenpark"
            },
            {
                "id": 31002,
                "name": "Waterpretpark",
                "slug": "waterpretpark"
            },
            {
                "id": 31003,
                "name": "Kinderboerderij",
                "slug": "kinderboerderij"
            },
            {
                "id": 31004,
                "name": "Zwembad",
                "slug": "zwembad"
            },
            {
                "id": 31005,
                "name": "Fitness",
                "slug": "fitness"
            },
            {
                "id": 31006,
                "name": "Racketsporten",
                "slug": "racketsporten"
            },
            {
                "id": 31007,
                "name": "Balsporten",
                "slug": "balsporten"
            },
            {
                "id": 31008,
                "name": "Watersporten",
                "slug": "watersporten"
            },
            {
                "id": 31009,
                "name": "Bowling",
                "slug": "bowling"
            },
            {
                "id": 31010,
                "name": "Wintersport",
                "slug": "wintersport"
            },
            {
                "id": 31011,
                "name": "Dansen en Aerobics",
                "slug": "dansen-en-aerobics"
            },
            {
                "id": 31012,
                "name": "(Binnen) Speeltuin",
                "slug": "binnen-speeltuin"
            },
            {
                "id": 31013,
                "name": "Klimmen",
                "slug": "klimmen"
            },
            {
                "id": 31014,
                "name": "Yoga",
                "slug": "yoga"
            },
            {
                "id": 31015,
                "name": "Fietsen (activiteit)",
                "slug": "fietsen-activiteit"
            },
            {
                "id": 31017,
                "name": "Sportwinkel",
                "slug": "sportwinkel"
            },
            {
                "id": 31018,
                "name": "Tuinen en parken",
                "slug": "tuinen-en-parken"
            },
            {
                "id": 31019,
                "name": "Provinciaal Domein",
                "slug": "provinciaal-domein"
            },
            {
                "id": 31021,
                "name": "Natuurgebied",
                "slug": "natuurgebied"
            },
            {
                "id": 31022,
                "name": "Bars en cafés",
                "slug": "bars-en-cafes"
            },
            {
                "id": 31023,
                "name": "Restaurant",
                "slug": "restaurant"
            },
            {
                "id": 31024,
                "name": "Schoolrestaurant",
                "slug": "schoolrestaurant"
            },
            {
                "id": 31025,
                "name": "STEM-cursus",
                "slug": "stem-cursus"
            },
            {
                "id": 31026,
                "name": "Taalcursus",
                "slug": "taalcursus"
            },
            {
                "id": 31027,
                "name": "Communicatiecursus",
                "slug": "communicatiecursus"
            },
            {
                "id": 31028,
                "name": "Muziekcursus",
                "slug": "muziekcursus"
            },
            {
                "id": 31029,
                "name": "Theatercursus",
                "slug": "theatercursus"
            },
            {
                "id": 31030,
                "name": "Milieu-educatie",
                "slug": "milieu-educatie"
            },
            {
                "id": 31031,
                "name": "Wetenschapsmusea",
                "slug": "wetenschapsmusea"
            },
            {
                "id": 31032,
                "name": "Computers",
                "slug": "computers"
            },
            {
                "id": 31033,
                "name": "Tablets",
                "slug": "tablets"
            },
            {
                "id": 31034,
                "name": "Telefoons en smartphones",
                "slug": "telefoons-en-smartphones"
            },
            {
                "id": 31035,
                "name": "Printers",
                "slug": "printers"
            },
            {
                "id": 31036,
                "name": "Bibliotheken",
                "slug": "bibliotheken"
            },
            {
                "id": 31037,
                "name": "Boeken",
                "slug": "boeken"
            },
            {
                "id": 31038,
                "name": "Strips",
                "slug": "strips"
            },
            {
                "id": 31039,
                "name": "Poëzie",
                "slug": "poezie"
            },
            {
                "id": 31040,
                "name": "Vaktijdschrift",
                "slug": "vaktijdschrift"
            },
            {
                "id": 31041,
                "name": "Vrijetijdsmagazine",
                "slug": "vrijetijdsmagazine"
            },
            {
                "id": 31042,
                "name": "Kranten",
                "slug": "kranten"
            },
            {
                "id": 31044,
                "name": "Speelgoed",
                "slug": "speelgoed"
            },
            {
                "id": 31045,
                "name": "Knutselmateriaal",
                "slug": "knutselmateriaal"
            },
            {
                "id": 31046,
                "name": "Kantoorbenodigdheden",
                "slug": "kantoorbenodigdheden"
            },
            {
                "id": 31047,
                "name": "Copycenters",
                "slug": "copycenters"
            },
            {
                "id": 31048,
                "name": "Kledij",
                "slug": "kledij"
            },
            {
                "id": 31049,
                "name": "Interieur",
                "slug": "interieur"
            },
            {
                "id": 31050,
                "name": "Museum voor beeldende kunsten",
                "slug": "museum-voor-beeldende-kunsten"
            },
            {
                "id": 31051,
                "name": "Toegepaste kunst en design",
                "slug": "toegepaste-kunst-en-design"
            },
            {
                "id": 31052,
                "name": "Geschiedkundig museum",
                "slug": "geschiedkundig-museum"
            },
            {
                "id": 31053,
                "name": "Architectuurmuseum",
                "slug": "architectuurmuseum"
            },
            {
                "id": 31054,
                "name": "Modemuseum",
                "slug": "modemuseum"
            },
            {
                "id": 31055,
                "name": "Literatuurmuseum",
                "slug": "literatuurmuseum"
            },
            {
                "id": 31056,
                "name": "Dansvoorstelling",
                "slug": "dansvoorstelling"
            },
            {
                "id": 31057,
                "name": "Concert",
                "slug": "concert"
            },
            {
                "id": 31058,
                "name": "Theatervoorstelling",
                "slug": "theatervoorstelling"
            },
            {
                "id": 31059,
                "name": "Film",
                "slug": "film"
            },
            {
                "id": 31060,
                "name": "CC",
                "slug": "cc"
            },
            {
                "id": 31063,
                "name": "Fietswinkel",
                "slug": "fietswinkel"
            },
            {
                "id": 31064,
                "name": "Vliegreizen",
                "slug": "vliegreizen"
            },
            {
                "id": 31065,
                "name": "Reizen",
                "slug": "reizen"
            },
            {
                "id": 31066,
                "name": "Tanken",
                "slug": "tanken"
            },
            {
                "id": 31067,
                "name": "Auto",
                "slug": "auto"
            },
            {
                "id": 31068,
                "name": "Jongerenvakantie",
                "slug": "jongerenvakantie"
            },
            {
                "id": 31069,
                "name": "Jeugdherberg",
                "slug": "jeugdherberg"
            },
            {
                "id": 31070,
                "name": "Vakantiepark",
                "slug": "vakantiepark"
            },
            {
                "id": 31275,
                "name": "Nieuwsmagazine",
                "slug": "nieuwsmagazine"
            },
            {
                "id": 31276,
                "name": "(Boeken)tassen",
                "slug": "boekentassen"
            },
            {
                "id": 31277,
                "name": "Fotografie-expo",
                "slug": "fotografie-expo"
            },
            {
                "id": 31278,
                "name": "Archeologisch museum",
                "slug": "archeologisch-museum"
            },
            {
                "id": 31279,
                "name": "Vakantiehuisje",
                "slug": "vakantiehuisje"
            },
            {
                "id": 31280,
                "name": "Hotel",
                "slug": "hotel"
            },
            {
                "id": 31281,
                "name": "B&amp;B",
                "slug": "bb"
            },
            {
                "id": 32071,
                "name": "Kapsalon",
                "slug": "kapsalon"
            },
            {
                "id": 32072,
                "name": "Schoonheidssalon",
                "slug": "schoonheidssalon"
            },
            {
                "id": 32073,
                "name": "Wellness",
                "slug": "wellness"
            },
            {
                "id": 32074,
                "name": "Optiek",
                "slug": "optiek"
            },
            {
                "id": 32075,
                "name": "Etenswaren",
                "slug": "etenswaren"
            },
            {
                "id": 32076,
                "name": "Geschenken",
                "slug": "geschenken"
            },
            {
                "id": 32077,
                "name": "Rondvaarten",
                "slug": "rondvaarten"
            },
            {
                "id": 32078,
                "name": "Licht en geluid",
                "slug": "licht-en-geluid"
            },
            {
                "id": 32079,
                "name": "Optisch materiaal",
                "slug": "optisch-materiaal"
            },
            {
                "id": 32080,
                "name": "Gevechtssporten",
                "slug": "gevechtssporten"
            },
            {
                "id": 32081,
                "name": "Actieve spelen",
                "slug": "actieve-spelen"
            },
            {
                "id": 32555,
                "name": "Tuincentrum",
                "slug": "tuincentrum"
            },
            {
                "id": 32556,
                "name": "Muziekwinkel",
                "slug": "muziekwinkel"
            },
            {
                "id": 32557,
                "name": "Verzekeringen",
                "slug": "verzekeringen"
            },
            {
                "id": 33841,
                "name": "Monumenten",
                "slug": "monumenten"
            },
            {
                "id": 33842,
                "name": "Cultureel Erfgoed",
                "slug": "cultureel-erfgoed"
            }
        ],
        "categories": [
            {
                "slug": "attractie-en-dierenparken",
                "name": "Attractie- en dierenparken",
                "subcategories": [
                    {
                        "path": "attractie-en-dierenparken|attractie-en-dierenparken",
                        "slug": "attractie-en-dierenparken",
                        "name": "Attractie- en dierenparken"
                    }
                ]
            },
            {
                "slug": "sport-en-actief",
                "name": "Sport en actief",
                "subcategories": [
                    {
                        "path": "sport-en-actief|activiteiten",
                        "slug": "activiteiten",
                        "name": "Activiteiten"
                    },
                    {
                        "path": "sport-en-actief|sportartikelen",
                        "slug": "sportartikelen",
                        "name": "Sportartikelen"
                    }
                ]
            },
            {
                "slug": "tuinen-en-natuurgebieden",
                "name": "Tuinen en Natuurgebieden",
                "subcategories": [
                    {
                        "path": "tuinen-en-natuurgebieden|tuinen-en-natuurgebieden",
                        "slug": "tuinen-en-natuurgebieden",
                        "name": "Tuinen en Natuurgebieden"
                    }
                ]
            },
            {
                "slug": "eten-en-drinken",
                "name": "Eten en drinken",
                "subcategories": [
                    {
                        "path": "eten-en-drinken|eten-en-drinken",
                        "slug": "eten-en-drinken",
                        "name": "Eten en drinken"
                    }
                ]
            },
            {
                "slug": "cursussen-en-vorming",
                "name": "Cursussen en vorming",
                "subcategories": [
                    {
                        "path": "cursussen-en-vorming|cursussen-en-vorming",
                        "slug": "cursussen-en-vorming",
                        "name": "Cursussen en vorming"
                    }
                ]
            },
            {
                "slug": "wetenschap-en-technologie",
                "name": "Wetenschap en Technologie",
                "subcategories": [
                    {
                        "path": "wetenschap-en-technologie|expo-en-musea",
                        "slug": "expo-en-musea",
                        "name": "Expo en musea"
                    },
                    {
                        "path": "wetenschap-en-technologie|milieu-educatie",
                        "slug": "milieu-educatie",
                        "name": "Milieu-educatie"
                    },
                    {
                        "path": "wetenschap-en-technologie|multimedia",
                        "slug": "multimedia",
                        "name": "Multimedia"
                    }
                ]
            },
            {
                "slug": "leesvoer",
                "name": "Leesvoer",
                "subcategories": [
                    {
                        "path": "leesvoer|bibliotheken",
                        "slug": "bibliotheken",
                        "name": "Bibliotheken"
                    },
                    {
                        "path": "leesvoer|boeken-en-strips",
                        "slug": "boeken-en-strips",
                        "name": "Boeken en strips"
                    },
                    {
                        "path": "leesvoer|kranten-en-tijdschriften",
                        "slug": "kranten-en-tijdschriften",
                        "name": "Kranten en Tijdschriften"
                    }
                ]
            },
            {
                "slug": "winkelen",
                "name": "Winkelen",
                "subcategories": [
                    {
                        "path": "winkelen|multimedia",
                        "slug": "multimedia",
                        "name": "Multimedia"
                    },
                    {
                        "path": "winkelen|speelgoed-en-geschenken",
                        "slug": "speelgoed-en-geschenken",
                        "name": "Speelgoed en geschenken"
                    },
                    {
                        "path": "winkelen|knutsel-en-kantoorgerief",
                        "slug": "knutsel-en-kantoorgerief",
                        "name": "Knutsel- en kantoorgerief"
                    },
                    {
                        "path": "winkelen|copycenters",
                        "slug": "copycenters",
                        "name": "Copycenters"
                    },
                    {
                        "path": "winkelen|sportartikelen",
                        "slug": "sportartikelen",
                        "name": "Sportartikelen"
                    },
                    {
                        "path": "winkelen|accessoires-en-kledij",
                        "slug": "accessoires-en-kledij",
                        "name": "Accessoires en kledij"
                    },
                    {
                        "path": "winkelen|interieur",
                        "slug": "interieur",
                        "name": "Interieur"
                    },
                    {
                        "path": "winkelen|boeken-en-strips",
                        "slug": "boeken-en-strips",
                        "name": "Boeken en strips"
                    },
                    {
                        "path": "winkelen|etenswaren",
                        "slug": "etenswaren",
                        "name": "Etenswaren"
                    },
                    {
                        "path": "winkelen|tuincentrum",
                        "slug": "tuincentrum",
                        "name": "Tuincentrum"
                    },
                    {
                        "path": "winkelen|muziekwinkel",
                        "slug": "muziekwinkel",
                        "name": "Muziekwinkel"
                    },
                    {
                        "path": "winkelen|verzekeringen",
                        "slug": "verzekeringen",
                        "name": "Verzekeringen"
                    }
                ]
            },
            {
                "slug": "cultuur-en-geschiedenis",
                "name": "Cultuur en Geschiedenis",
                "subcategories": [
                    {
                        "path": "cultuur-en-geschiedenis|museum-en-expo",
                        "slug": "museum-en-expo",
                        "name": "Museum en Expo"
                    },
                    {
                        "path": "cultuur-en-geschiedenis|dans-en-muziek",
                        "slug": "dans-en-muziek",
                        "name": "Dans en Muziek"
                    },
                    {
                        "path": "cultuur-en-geschiedenis|theater",
                        "slug": "theater",
                        "name": "Theater"
                    },
                    {
                        "path": "cultuur-en-geschiedenis|film",
                        "slug": "film",
                        "name": "Film"
                    },
                    {
                        "path": "cultuur-en-geschiedenis|culturele-centra",
                        "slug": "culturele-centra",
                        "name": "Culturele centra"
                    },
                    {
                        "path": "cultuur-en-geschiedenis|erfgoed",
                        "slug": "erfgoed",
                        "name": "Erfgoed"
                    }
                ]
            },
            {
                "slug": "reizen-en-mobiliteit",
                "name": "Reizen en mobiliteit",
                "subcategories": [
                    {
                        "path": "reizen-en-mobiliteit|fietsen",
                        "slug": "fietsen",
                        "name": "Fietsen"
                    },
                    {
                        "path": "reizen-en-mobiliteit|rondvaarten",
                        "slug": "rondvaarten",
                        "name": "Rondvaarten"
                    },
                    {
                        "path": "reizen-en-mobiliteit|reisagentschappen",
                        "slug": "reisagentschappen",
                        "name": "Reisagentschappen"
                    },
                    {
                        "path": "reizen-en-mobiliteit|auto",
                        "slug": "auto",
                        "name": "Auto"
                    },
                    {
                        "path": "reizen-en-mobiliteit|vakantieverblijven",
                        "slug": "vakantieverblijven",
                        "name": "Vakantieverblijven"
                    }
                ]
            },
            {
                "slug": "wellness-en-verzorging",
                "name": "Wellness en verzorging",
                "subcategories": [
                    {
                        "path": "wellness-en-verzorging|kapsalon",
                        "slug": "kapsalon",
                        "name": "Kapsalon"
                    },
                    {
                        "path": "wellness-en-verzorging|schoonheidssalon",
                        "slug": "schoonheidssalon",
                        "name": "Schoonheidssalon"
                    },
                    {
                        "path": "wellness-en-verzorging|wellness",
                        "slug": "wellness",
                        "name": "Wellness"
                    }
                ]
            }
        ],
        "vakken": [
            {
                "id": 297,
                "name": "Aardrijkskunde &amp; biologie",
                "slug": "aardrijkskunde-biologie"
            },
            {
                "id": 298,
                "name": "Geschiedenis &amp; cultuur",
                "slug": "geschiedenis-cultuur"
            },
            {
                "id": 299,
                "name": "Handel &amp; economie",
                "slug": "handel-economie"
            },
            {
                "id": 300,
                "name": "Levensbeschouwing",
                "slug": "levensbeschouwing"
            },
            {
                "id": 301,
                "name": "LO &amp; gezondheid",
                "slug": "lo-gezondheid"
            },
            {
                "id": 302,
                "name": "Muzische vakken",
                "slug": "muzische-vakken"
            },
            {
                "id": 303,
                "name": "Taalvakken",
                "slug": "taalvakken"
            },
            {
                "id": 304,
                "name": "Techniek &amp; praktijk",
                "slug": "techniek-praktijk"
            },
            {
                "id": 305,
                "name": "Wiskunde &amp; exacte wetenschappen",
                "slug": "wiskunde-exacte-wetenschappen"
            },
            {
                "id": 36940,
                "name": "Mens en maatschappij",
                "slug": "mens-en-maatschappij"
            },
            {
                "id": 36943,
                "name": "Wereldoriëntatie",
                "slug": "wereldorientatie"
            },
            {
                "id": 36949,
                "name": "ICT",
                "slug": "ict"
            },
            {
                "id": 36957,
                "name": "Alle vakken",
                "slug": "alle-vakken"
            },
            {
                "id": 36963,
                "name": "Esthetica",
                "slug": "esthetica"
            },
            {
                "id": 36964,
                "name": "Kunstgeschiedenis",
                "slug": "kunstgeschiedenis"
            }
        ],
        "voorzieningen": [
            {
                "id": 278,
                "name": "Audiodescriptie",
                "slug": "audiodescriptie"
            },
            {
                "id": 279,
                "name": "Brochure in gesproken vorm",
                "slug": "brochure-in-gesproken-vorm"
            },
            {
                "id": 280,
                "name": "Brochure in grote letters",
                "slug": "brochure-in-grote-letters"
            },
            {
                "id": 281,
                "name": "Ringleiding",
                "slug": "ringleiding"
            },
            {
                "id": 282,
                "name": "Rolstoel ter beschikking",
                "slug": "rolstoel-ter-beschikking"
            },
            {
                "id": 283,
                "name": "Voorzieningen voor hulp- en geleidehonden",
                "slug": "voorzieningen-voor-hulp-en-geleidehonden"
            },
            {
                "id": 296,
                "name": "Toegankelijk met een rolstoel",
                "slug": "toegankelijk-met-een-rolstoel"
            },
            {
                "id": 36952,
                "name": "Gratis aangepaste rondleiding voor blinden en slechtzienden",
                "slug": "gratis-aangepaste-rondleiding-voor-blinden-en-slechtzienden"
            },
            {
                "id": 36953,
                "name": "Museumkaart in pictogrammen voor mensen met spraakbeperking",
                "slug": "museumkaart-in-pictogrammen-voor-mensen-met-spraakbeperking"
            },
            {
                "id": 36954,
                "name": "Rondleiding voor mensen met dementie",
                "slug": "rondleiding-voor-mensen-met-dementie"
            },
            {
                "id": 36955,
                "name": "Voorbereidend stappenplan voor mensen met autisme",
                "slug": "voorbereidend-stappenplan-voor-mensen-met-autisme"
            },
            {
                "id": 36956,
                "name": "Aangepaste toiletten",
                "slug": "aangepaste-toiletten"
            },
            {
                "id": 36958,
                "name": "Infoborden voor bezoekers met auditieve beperking",
                "slug": "infoborden-voor-bezoekers-met-auditieve-beperking"
            },
            {
                "id": 36959,
                "name": "Klapstoelen beschikbaar",
                "slug": "klapstoelen-beschikbaar"
            },
            {
                "id": 36962,
                "name": "Lift",
                "slug": "lift"
            },
            {
                "id": 36965,
                "name": "Rondleiding voor blinden en slechtzienden",
                "slug": "rondleiding-voor-blinden-en-slechtzienden"
            },
            {
                "id": 36966,
                "name": "Gedeeltelijk toegankelijk met een rolstoel",
                "slug": "gedeeltelijk-toegankelijk-met-een-rolstoel"
            },
            {
                "id": 36977,
                "name": "bolderkar ter beschikking",
                "slug": "bolderkar-ter-beschikking"
            }
        ]
    },
    "version": "v3-24.3.1"
}

Enkele taxonomy

Request: /v3/voordelen/tags

{
    "authentication": {
        "client_name": "View_Voordeel",
        "quality": "valid",
        "message": "Geldige API-key."
    },
    "requested_at": "2024-04-12T09:50:01+00:00",
    "message": "Geldig verzoek.",
    "status": 200,
    "quality": "valid",
    "found": [
        {
            "id": 31000,
            "name": "Pretpark",
            "slug": "pretpark"
        },
        {
            "id": 31001,
            "name": "Dierenpark",
            "slug": "dierenpark"
        },
        {
            "id": 31002,
            "name": "Waterpretpark",
            "slug": "waterpretpark"
        },
        {
            "id": 31003,
            "name": "Kinderboerderij",
            "slug": "kinderboerderij"
        },
        {
            "id": 31004,
            "name": "Zwembad",
            "slug": "zwembad"
        },
        {
            "id": 31005,
            "name": "Fitness",
            "slug": "fitness"
        },
        {
            "id": 31006,
            "name": "Racketsporten",
            "slug": "racketsporten"
        },
        {
            "id": 31007,
            "name": "Balsporten",
            "slug": "balsporten"
        },
        {
            "id": 31008,
            "name": "Watersporten",
            "slug": "watersporten"
        },
        {
            "id": 31009,
            "name": "Bowling",
            "slug": "bowling"
        },
        {
            "id": 31010,
            "name": "Wintersport",
            "slug": "wintersport"
        },
        {
            "id": 31011,
            "name": "Dansen en Aerobics",
            "slug": "dansen-en-aerobics"
        },
        {
            "id": 31012,
            "name": "(Binnen) Speeltuin",
            "slug": "binnen-speeltuin"
        },
        {
            "id": 31013,
            "name": "Klimmen",
            "slug": "klimmen"
        },
        {
            "id": 31014,
            "name": "Yoga",
            "slug": "yoga"
        },
        {
            "id": 31015,
            "name": "Fietsen (activiteit)",
            "slug": "fietsen-activiteit"
        },
        {
            "id": 31017,
            "name": "Sportwinkel",
            "slug": "sportwinkel"
        },
        {
            "id": 31018,
            "name": "Tuinen en parken",
            "slug": "tuinen-en-parken"
        },
        {
            "id": 31019,
            "name": "Provinciaal Domein",
            "slug": "provinciaal-domein"
        },
        {
            "id": 31021,
            "name": "Natuurgebied",
            "slug": "natuurgebied"
        },
        {
            "id": 31022,
            "name": "Bars en cafés",
            "slug": "bars-en-cafes"
        },
        {
            "id": 31023,
            "name": "Restaurant",
            "slug": "restaurant"
        },
        {
            "id": 31024,
            "name": "Schoolrestaurant",
            "slug": "schoolrestaurant"
        },
        {
            "id": 31025,
            "name": "STEM-cursus",
            "slug": "stem-cursus"
        },
        {
            "id": 31026,
            "name": "Taalcursus",
            "slug": "taalcursus"
        },
        {
            "id": 31027,
            "name": "Communicatiecursus",
            "slug": "communicatiecursus"
        },
        {
            "id": 31028,
            "name": "Muziekcursus",
            "slug": "muziekcursus"
        },
        {
            "id": 31029,
            "name": "Theatercursus",
            "slug": "theatercursus"
        },
        {
            "id": 31030,
            "name": "Milieu-educatie",
            "slug": "milieu-educatie"
        },
        {
            "id": 31031,
            "name": "Wetenschapsmusea",
            "slug": "wetenschapsmusea"
        },
        {
            "id": 31032,
            "name": "Computers",
            "slug": "computers"
        },
        {
            "id": 31033,
            "name": "Tablets",
            "slug": "tablets"
        },
        {
            "id": 31034,
            "name": "Telefoons en smartphones",
            "slug": "telefoons-en-smartphones"
        },
        {
            "id": 31035,
            "name": "Printers",
            "slug": "printers"
        },
        {
            "id": 31036,
            "name": "Bibliotheken",
            "slug": "bibliotheken"
        },
        {
            "id": 31037,
            "name": "Boeken",
            "slug": "boeken"
        },
        {
            "id": 31038,
            "name": "Strips",
            "slug": "strips"
        },
        {
            "id": 31039,
            "name": "Poëzie",
            "slug": "poezie"
        },
        {
            "id": 31040,
            "name": "Vaktijdschrift",
            "slug": "vaktijdschrift"
        },
        {
            "id": 31041,
            "name": "Vrijetijdsmagazine",
            "slug": "vrijetijdsmagazine"
        },
        {
            "id": 31042,
            "name": "Kranten",
            "slug": "kranten"
        },
        {
            "id": 31044,
            "name": "Speelgoed",
            "slug": "speelgoed"
        },
        {
            "id": 31045,
            "name": "Knutselmateriaal",
            "slug": "knutselmateriaal"
        },
        {
            "id": 31046,
            "name": "Kantoorbenodigdheden",
            "slug": "kantoorbenodigdheden"
        },
        {
            "id": 31047,
            "name": "Copycenters",
            "slug": "copycenters"
        },
        {
            "id": 31048,
            "name": "Kledij",
            "slug": "kledij"
        },
        {
            "id": 31049,
            "name": "Interieur",
            "slug": "interieur"
        },
        {
            "id": 31050,
            "name": "Museum voor beeldende kunsten",
            "slug": "museum-voor-beeldende-kunsten"
        },
        {
            "id": 31051,
            "name": "Toegepaste kunst en design",
            "slug": "toegepaste-kunst-en-design"
        },
        {
            "id": 31052,
            "name": "Geschiedkundig museum",
            "slug": "geschiedkundig-museum"
        },
        {
            "id": 31053,
            "name": "Architectuurmuseum",
            "slug": "architectuurmuseum"
        },
        {
            "id": 31054,
            "name": "Modemuseum",
            "slug": "modemuseum"
        },
        {
            "id": 31055,
            "name": "Literatuurmuseum",
            "slug": "literatuurmuseum"
        },
        {
            "id": 31056,
            "name": "Dansvoorstelling",
            "slug": "dansvoorstelling"
        },
        {
            "id": 31057,
            "name": "Concert",
            "slug": "concert"
        },
        {
            "id": 31058,
            "name": "Theatervoorstelling",
            "slug": "theatervoorstelling"
        },
        {
            "id": 31059,
            "name": "Film",
            "slug": "film"
        },
        {
            "id": 31060,
            "name": "CC",
            "slug": "cc"
        },
        {
            "id": 31063,
            "name": "Fietswinkel",
            "slug": "fietswinkel"
        },
        {
            "id": 31064,
            "name": "Vliegreizen",
            "slug": "vliegreizen"
        },
        {
            "id": 31065,
            "name": "Reizen",
            "slug": "reizen"
        },
        {
            "id": 31066,
            "name": "Tanken",
            "slug": "tanken"
        },
        {
            "id": 31067,
            "name": "Auto",
            "slug": "auto"
        },
        {
            "id": 31068,
            "name": "Jongerenvakantie",
            "slug": "jongerenvakantie"
        },
        {
            "id": 31069,
            "name": "Jeugdherberg",
            "slug": "jeugdherberg"
        },
        {
            "id": 31070,
            "name": "Vakantiepark",
            "slug": "vakantiepark"
        },
        {
            "id": 31275,
            "name": "Nieuwsmagazine",
            "slug": "nieuwsmagazine"
        },
        {
            "id": 31276,
            "name": "(Boeken)tassen",
            "slug": "boekentassen"
        },
        {
            "id": 31277,
            "name": "Fotografie-expo",
            "slug": "fotografie-expo"
        },
        {
            "id": 31278,
            "name": "Archeologisch museum",
            "slug": "archeologisch-museum"
        },
        {
            "id": 31279,
            "name": "Vakantiehuisje",
            "slug": "vakantiehuisje"
        },
        {
            "id": 31280,
            "name": "Hotel",
            "slug": "hotel"
        },
        {
            "id": 31281,
            "name": "B&amp;B",
            "slug": "bb"
        },
        {
            "id": 32071,
            "name": "Kapsalon",
            "slug": "kapsalon"
        },
        {
            "id": 32072,
            "name": "Schoonheidssalon",
            "slug": "schoonheidssalon"
        },
        {
            "id": 32073,
            "name": "Wellness",
            "slug": "wellness"
        },
        {
            "id": 32074,
            "name": "Optiek",
            "slug": "optiek"
        },
        {
            "id": 32075,
            "name": "Etenswaren",
            "slug": "etenswaren"
        },
        {
            "id": 32076,
            "name": "Geschenken",
            "slug": "geschenken"
        },
        {
            "id": 32077,
            "name": "Rondvaarten",
            "slug": "rondvaarten"
        },
        {
            "id": 32078,
            "name": "Licht en geluid",
            "slug": "licht-en-geluid"
        },
        {
            "id": 32079,
            "name": "Optisch materiaal",
            "slug": "optisch-materiaal"
        },
        {
            "id": 32080,
            "name": "Gevechtssporten",
            "slug": "gevechtssporten"
        },
        {
            "id": 32081,
            "name": "Actieve spelen",
            "slug": "actieve-spelen"
        },
        {
            "id": 32555,
            "name": "Tuincentrum",
            "slug": "tuincentrum"
        },
        {
            "id": 32556,
            "name": "Muziekwinkel",
            "slug": "muziekwinkel"
        },
        {
            "id": 32557,
            "name": "Verzekeringen",
            "slug": "verzekeringen"
        },
        {
            "id": 33841,
            "name": "Monumenten",
            "slug": "monumenten"
        },
        {
            "id": 33842,
            "name": "Cultureel Erfgoed",
            "slug": "cultureel-erfgoed"
        }
    ],
    "version": "v3-24.3.1"
}

Authenticatie

Om informatie terug te krijgen, moet een geldige API key meegegeven worden in de X-Auth-Key header. Deze API key kan aangevraagd worden bij Klasse.