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
Rechten
Vacatures

Versie

Dit is versie 1.7 van de Tuesday Vacature-API.
De API is constant in ontwikkeling.
Geregistreerde ontwikkelaars ontvangen tijdig bericht van belangrijke uitbreidingen en wijzigingen.
Laatste update vrijdag 1 maart 2019.
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.

Rechten

This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

Vacatures

Het Vacature-object geeft een of meer vacatures terug.

API Endpoint

https://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

Request

Haal de gegevens op van vacatures in het Nederlands.

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

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

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

Haal de gegevens op van vacatures die toegevoegd zijn na 2020-05-30.

GET https://vacature-api.tuesday.nl/api/vacatures?createdsince=2018-05-18

Haal de gegevens op van vacatures die gewijzigd zijn na 2020-05-30.

GET https://vacature-api.tuesday.nl/api/vacatures?changedsince=2018-05-18

Haal de gegevens op van vacatures die verwijderd zijn na 2020-05-30.

GET https://vacature-api.tuesday.nl/api/vacatures?deletedsince=2018-05-18

Combineer de parameters.

GET https://vacature-api.tuesday.nl/api/vacatures?createdsince=2014-10-20&changedsince=2018-08-25&language=en

Response JSON

{
    "VERSION":1.7,
    "VACATURES":[{
        "Location":"6525 GA Nijmegen",
        "Language":"NL",
        "Site":"https://www.radboudumc.nl",
        "Deeplink":"https://www.radboudumc.nl/vacatures/52081-polikliniekassistent-polikliniek-inwendige-specialismen-reumatische-ziekten",
        "PayScale":"Schaal 5, max. €36589",
        "Lastseen":"2017-12-07T09:22:00+01:00",
        "Zipcode":"6525 GA",
        "Logo":"https://www.radboudumc.nl/assets/img/layout/logo-RadboudUMC.png",
        "Contract":"Bepaalde tijd",
        "Department":"Reumatische Ziekten",
        "Education":"MBO",
        "Organisation":"Radboudumc",
        "Function":"Polikliniekassistent polikliniek Inwendige Specialismen Reumatische Ziekten",
        "ContractPeriod":"1 jaar met uitzicht op een contract voor onbepaalde tijd",
        "Closes":"2017-12-21T00:00:00+01:00",
        "City":"Nijmegen",
        "Hours":28,
        "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":"Bepaalde tijd"
    }]
}

Response XML

 <?xml version="1.0" encoding="UTF-8"?>
<VACATURES>
    <VERSION>1.7</VERSION>
    <VACATURES>
        <VACATURE>
            <Location>6525 GA Nijmegen</Location>
            <Language>NL</Language>
            <Site>https://www.radboudumc.nl</Site>
            <Deeplink>https://www.radboudumc.nl/vacatures/52081-polikliniekassistent-polikliniek-inwendige-specialismen-reumatische-ziekten</Deeplink>
            <PayScale>Schaal 5, max. &amp;euro;36589</PayScale>
            <Lastseen>2017-12-07T09:22:00+01:00</Lastseen>
            <Zipcode>6525 GA</Zipcode>
            <Logo>https://www.radboudumc.nl/assets/img/layout/logo-RadboudUMC.png</Logo>
            <Contract>Bepaalde tijd</Contract>
            <Department>Reumatische Ziekten</Department>
            <Education>MBO</Education>
            <Organisation>Radboudumc</Organisation>
            <Function>Polikliniekassistent polikliniek Inwendige Specialismen Reumatische Ziekten</Function>
            <ContractPeriod>1 jaar met uitzicht op een contract voor onbepaalde tijd</ContractPeriod>
            <Closes>2017-12-21T00:00:00+01:00</Closes>
            <City>Nijmegen</City>
            <Hours>28</Hours>
            <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>Bepaalde tijd</Type>
        </VACATURE>
    </VACATURES>
</VACATURES>