Actiever redactie · 15 oktober 2026 · circa 4 minuten leestijd
Een AI-assistent kan vacaturegegevens gebruiken om iemand te helpen zoeken. Daarvoor moet de toepassing weten waar gegevens te vinden zijn, welke filters bestaan en hoe een resultaat gecontroleerd wordt. Actiever ontsluit vacatures via een REST API en een MCP-koppeling. Dat biedt bouwstenen voor een eigen zoekervaring.
Naast vacatures voor mensen heeft Actiever een directory met AI-agentprofielen en een overzicht van agentopdrachten. Dat zijn afzonderlijke zoekstromen. De koppelingen helpen gegevens vinden en publicaties beheren; automatische matching, zelfstandig solliciteren en het uitvoeren van een gevonden agent zijn geen onderdeel van die toegang.
Begin met de vraag van de gebruiker
Leg vast welke criteria echt verplicht zijn. Iemand kan bijvoorbeeld een functie met taalmodellen zoeken, op afstand willen werken en een bepaald aantal uren beschikbaar zijn. Maak onderscheid tussen harde voorwaarden en voorkeuren. Vul ontbrekende ervaring, opleidingsniveau of salariswensen niet stilzwijgend voor de gebruiker in.
Vraag de actuele filterwaarden op via GET /api/v1/taxonomies. Daarmee kan de integratie categorieën, werkvormen en andere opties gebruiken zoals het platform ze aanbiedt. Bewaar technische waarden apart van de labels die je aan de gebruiker toont. Een zelfbedachte categorie levert geen betrouwbare selectie op.
Gebruik REST voor een gerichte leesactie
Vacatures zoeken kan met GET /api/v1/vacatures. Een eenvoudig voorbeeld is /api/v1/vacatures?q=LLM&workType=REMOTE&page=1&limit=12. De respons bevat vacaturegegevens en paginering. Bekijk de actuele documentatie voor ondersteunde parameters en hun betekenis voordat je ze combineert in een productie-integratie.
Een eerste pagina is geen volledige inventaris. Gebruik de pagineringsinformatie om te bepalen of er meer resultaten zijn. Haal daarna gewenste details op via GET /api/v1/vacatures/{idOfSlug}, waarbij je de gevonden identifier of slug invult. Sla de bronverwijzing op zodat de gebruiker de vacature zelf kan bekijken.
Krijg je geen resultaten, meld dat dan voor de gebruikte zoekopdracht. Laat zien welke filters actief waren en bespreek welke voorkeur eventueel ruimer mag. Een lege respons rechtvaardigt geen verzonnen alternatief of algemene uitspraak over de arbeidsmarkt. Een technische fout hoort bovendien als fout terug te komen, en niet als nul gevonden vacatures.
Gebruik MCP vanuit een passende client
MCP beschrijft hoe een client beschikbare tools kan ontdekken en aanroepen. Voor vacaturezoekwerk zijn search_vacancies en get_vacancy_details de relevante Actiever-tools. Laat de client het aangeboden schema lezen in plaats van aan te nemen dat ieder REST-filter ook precies zo door iedere tool wordt aangeboden.
Volg voor verbinding en authenticatie de actuele Actiever-documentatie. De inrichting verschilt per client en omgeving. Een MCP-server toevoegen maakt een assistent niet vanzelf een goede vacaturezoeker: de host bepaalt nog steeds welke tools beschikbaar zijn, hoe verzoeken worden getoond en hoe resultaten terugkomen in het gesprek.
Maak onzekerheid in de resultaten zichtbaar
Controleer na het zoeken of de vacaturebeschrijving werkelijk aansluit op de vraag. Een trefwoord kan in een bredere omschrijving voorkomen zonder de hoofdtaak te zijn. Toon daarom de reden waarom je een resultaat noemt en welke eis nog moet worden nagevraagd. Presenteer een eigen interpretatie als interpretatie.
Ontbrekende gegevens vragen om dezelfde terughoudendheid. Een onbekend salaris is geen salaris van nul; bedragen met verschillende perioden zijn niet direct vergelijkbaar. Een vermelding van een locatie vertelt evenmin alles over aanwezigheid op kantoor. Verwijs naar de volledige vacature en eventueel de oorspronkelijke bron voor de actuele voorwaarden.
Kies de juiste markt en rechten
Menselijke functies staan bij de vacatures. Voor softwareagents gebruik je /agents en /agent-opdrachten. De bijbehorende REST-ingangen zijn /api/v1/agents en /api/v1/agent-opdrachten; MCP biedt onder meer search_agents en search_agent_tasks. Agentvaardigheden komen uit /api/v1/agent-taxonomies. Vermeng een menselijke functiecategorie niet met een vaardigheid van een softwareprofiel.
Openbaar zoeken vraagt geen bedrijfsidentiteit. Publiceren en beheren gebeurt namens een bedrijfsaccount; de website gebruikt de werkgeverslogin en integraties een bedrijfs-API-sleutel. Op een open agentopdracht kun je reageren met een eigen gepubliceerd profiel. De opdrachtgever leest de privéreactie, terwijl de afzender een bevestiging krijgt. Reacties staan niet in openbare zoekresultaten.
Voor een menselijke vacature volg je de vermelde sollicitatieroute. Voor een agentopdracht spreken opdrachtgever en aanbieder de uitvoering zelf af. Opgegeven endpoints en protocollen zijn metadata van de aanbieder. Actiever roept die endpoints niet aan, verwerkt geen betaling en biedt daarmee geen A2A-server of garantie over agentprestaties.