Tuesday Vacature-API: Documentatie

Introductie

De Tuesday Vacature-API verbindt uw website of applicatie met een of meer vacature databases.
De Tuesday Vacature-API stelt ontwikkelaars in staat om nieuwe applicaties te bouwen en hun toepassingen op nieuwe en creatieve manieren uit te breiden.

De Tuesday Vacature-API is een HTTP-based API die u kunt gebruiken om gegevens op te halen over vacatures op verschillende vakgebieden.
De API voorziet op dit moment in twee Response Formats: JSON en XML.

Inhoudsopgave

Versie
IP-restrictie
Paginering
Rechten
Vacatures

Versie

Dit is versie 2.0 van de Tuesday Vacature-API.
De API is constant in ontwikkeling.
Geregistreerde ontwikkelaars ontvangen tijdig bericht van belangrijke uitbreidingen en wijzigingen.
Laatste update dinsdag 24 september 2024.
Wilt u op de hoogte blijven over wijzigingen, stuur dan een e-mail aan: info[@]tuesday.nl
Bezoek de website van Tuesday om contact op te nemen.

IP-restrictie

De Tuesday Vacature-API werkt met een IP-restrictie en is alleen toegankelijk voor geregistreerde gebruikers.
Het is mogelijk om meerdere IP-adressen op de whitelist te zetten.

Paginering

Deze API heeft een limiet van 15.000 records per request. Alleen als een request méér records bevat dan dit maximum, moet paginering worden toegepast.
Om paginering te kunnen gebruiken, moet eerst de info-endpoint benaderd worden om het totale aantal en eventueel startrecord te bepalen.

GET https://vacature-api.tuesday.nl/vacatures?{request_filter}&format=info

Hierin worden volgende resultaten weergegeven:

maxAantalPerRequest: maximum aantal records op te halen per request.
aantalVacatures: aantal gevonden vacatures in de respons passend bij de filters die je in de URL hebt aangegeven.

Met de startRow parameter kan de volgende pagina opgehaald worden.
Bijvoorbeeld, om de tweede pagina op te halen, moet de volgende request gedaan worden:

GET https://vacature-api.tuesday.nl/vacatures?{request_filter}&format=csv&startRow=15000

Rechten

Vacatures

Het Vacature-object geeft een of meer vacatures terug.

API Endpoint

http://vacature-api.tuesday.nl/vacatures

Argumenten

parameter	type	korte beschrijving
format	string	'json' (default), 'xml' of 'csv'
language	string	2-letterige taalaanduiding volgens ISO 639-1
createdsince	date	format: 'YYYY-MM-DD' bijv 2014-10-20
changedsince	date	format: 'YYYY-MM-DD' bijv 2014-10-20
deletedsince	date	format: 'YYYY-MM-DD' bijv 2014-10-20
showmetadates	numeric	0 (default) of 1. Als 1, dan worden extra datums teruggegeven
enddate	date	format: 'YYYY-MM-DD' bijv 2014-10-20; werkt alleen i.c.m. createdsince, changedsince of deletedsince
startRow	numeric	de offset van de resultaten

Request

Haal de gegevens op van vacatures in het Nederlands.

GET http://vacature-api.tuesday.nl/vacatures?language=nl

Haal de gegevens op van vacatures met extra informatie over de metadata.

GET http://vacature-api.tuesday.nl/vacatures?showmetadates=1

Haal de gegevens op van vacatures die toegevoegd zijn na 2024-10-06.

GET http://vacature-api.tuesday.nl/vacatures?createdsince=2024-10-06

Haal de gegevens op van vacatures die gewijzigd zijn na 2024-10-06.

GET http://vacature-api.tuesday.nl/vacatures?changedsince=2024-10-06

Haal de gegevens op van vacatures die verwijderd zijn na 2024-10-06.

GET http://vacature-api.tuesday.nl/vacatures?deletedsince=2024-10-06

Controleer het aantal vacatures toegevoegd na 2024-10-06.

GET http://vacature-api.tuesday.nl/vacatures?createdsince=2024-10-06&format=info

Combineer de parameters.

GET http://vacature-api.tuesday.nl/vacatures?createdsince=2024-10-06&changedsince=2024-10-06&language=en

Response JSON

{
    "VERSION":"2.0",
    "VACATURES":[{
        "Location":"6525 GA Nijmegen",
        "Deeplink":"https://www.radboudumc.nl/vacatures/52081-polikliniekassistent-polikliniek-inwendige-specialismen-reumatische-ziekten",
        "PayScale":"Schaal 5, max. €36589",
        "Logo":"https://www.radboudumc.nl/assets/img/layout/logo-RadboudUMC.png",
        "Contract":"Bepaalde tijd",
        "Education":"MBO",
        "Dienstverband":"Fulltime",
        "Closes":"2017-12-21T00:00:00+01:00",
        "Description":"A description with possible some limited HTML",
        "Category":"Klinisch (mede) behandelen",
        "Firstseen":"2017-11-24T12:21:00+01:00",
        "Id":52081,
        "Workfield":"Ziekenhuizen",
        "Type":"Fulltime",
        "Language":"NL",
        "Site":"https://www.radboudumc.nl",
        "Lastseen":"2017-12-07T09:22:00+01:00",
        "Zipcode":"6525 GA",
        "Department":"Reumatische Ziekten",
        "Organisation":"Radboudumc",
        "Function":"Polikliniekassistent polikliniek Inwendige Specialismen Reumatische Ziekten",
        "ContractPeriod":"1 jaar met uitzicht op een contract voor onbepaalde tijd",
        "City":"Nijmegen",
        "Hours":"28",
        "SoortVacature":"Vacature"
    }]
}

Response XML

 <?xml version="1.0" encoding="UTF-8"?>
<VACATURES>
    <VERSION>2.0</VERSION>
    <VACATURES>
        <Vacature>
            <Location>6525 GA Nijmegen</Location>
            <Deeplink>https://www.radboudumc.nl/vacatures/52081-polikliniekassistent-polikliniek-inwendige-specialismen-reumatische-ziekten</Deeplink>
            <PayScale>Schaal 5, max. &amp;euro;36589</PayScale>
            <Logo>https://www.radboudumc.nl/assets/img/layout/logo-RadboudUMC.png</Logo>
            <Contract>Bepaalde tijd</Contract>
            <Education>MBO</Education>
            <Dienstverband>Fulltime</Dienstverband>
            <Closes>2017-12-21T00:00:00+01:00</Closes>
            <Description>A description with possible some limited HTML</Description>
            <Category>Klinisch (mede) behandelen</Category>
            <Firstseen>2017-11-24T12:21:00+01:00</Firstseen>
            <Id>52081</Id>
            <Workfield>Ziekenhuizen</Workfield>
            <Type>Fulltime</Type>
            <Language>NL</Language>
            <Site>https://www.radboudumc.nl</Site>
            <Lastseen>2017-12-07T09:22:00+01:00</Lastseen>
            <Zipcode>6525 GA</Zipcode>
            <Department>Reumatische Ziekten</Department>
            <Organisation>Radboudumc</Organisation>
            <Function>Polikliniekassistent polikliniek Inwendige Specialismen Reumatische Ziekten</Function>
            <ContractPeriod>1 jaar met uitzicht op een contract voor onbepaalde tijd</ContractPeriod>
            <City>Nijmegen</City>
            <Hours>28</Hours>
            <SoortVacature>Vacature</SoortVacature>
        </Vacature>
    </VACATURES>
</VACATURES>