Competent-data afnemen met Competent 2 API
Op deze pagina lees je alles over afnemen van Competent-data met de Competent 2 API.
Wat is Competent?
Competent is de standaardtaal voor beroepen en competenties in België. Competent is ook een databank van beroepscompetentieprofielen die je helpt om verder te kijken dan diploma's.
Meer over de mogelijkheden van Competent en beroepscompetentieprofielen.
Wat doet de Competent 2 API?
De Competent 2 API maakt een koppeling tussen de Competentdatabank en je eigen systeem mogelijk. Zo kan je geautomatiseerd informatie ophalen over beroepscompetentieprofielen en hun bouwblokken (competenties, soft skills, …) en deze integreren in je eigen systemen.
Voorwaarden voor gebruik
Je mag de Competent 2 API gebruiken, na het ondertekenen van een samenwerkingsovereenkomst.
Technische info
Releases
Competent krijgt meermaals per jaar een nieuwe release gebaseerd op evoluties op de arbeidsmarkt en inzichten die voortkomen uit het gebruik van de Competentstandaard.
Elke release heeft een duidelijk nummer. Gegevens, uitgedrukt volgens een bepaalde release, worden automatisch, in de mate van het mogelijke, geconverteerd naar een andere release.
Gegevensstructuur beroepscompetentieprofielen
Een release omvat een reeks beroepscompetentieprofielen (BCP).
Een beroepscompetentieprofiel bestaat uit verschillende bouwblokken:
- alternatieve benamingen
- vaktechnische competenties (essentiële en optionele)
- Een competentie omvat:
- een vaardigheid
- 0 of meerdere kennis-items
- 0 of meerder gedragsindicatoren
- softskills
- digitale skills
- leerbewijzen
- Een competentie omvat:
Codes en ID’s
Zowel beroepscompetentieprofielen als hun bouwblokken zijn voorzien van een ID en een code.
- Elk ID is uniek, blijft onveranderd over releases heen en is IT-technisch belangrijk voor identificatie.
- Codes kunnen per release verschillen en zijn hoofdzakelijk bedoeld om communicatie te faciliteren.
Voorbeeld:
- Beroepscompetentieprofiel: verpleegkundige
- ID: "cee9ee58-43a9-4300-b6c4-8bf1f7b59c28"
- Code: OP-202
Functionaliteiten
Met de Competent 2 API kun je via verschillende endpoints binnen een specifieke gekozen release:
- beroepscompetentieprofielen ophalen met alle bijbehorende bouwblokken met uitzondering van de digitale skills.
- afzonderlijke bouwblokken van een beroepscompetentieprofiel opvragen. Uitzondering: digitale skills zijn momenteel nog niet opvraagbaar.
- beroepscompetentieprofielen en bouwblokken opzoeken op basis van trefwoorden en andere parameters.
- gegevens opvragen gekoppeld aan een ID.
Met de Competent 2 API kun je ten slotte ook nagaan welke wijzigingen er doorgevoerd zijn tussen de release die je opgeeft en de voorgaande release.
Beveiliging
VDAB gebruikt de API-sleutel (een unieke lange cijfercode) als authenticatiemiddel.
De API's kunnen enkel benaderd worden via HTTPS-verbindingen die versleuteld zijn via TLS1.2 (of hoger) om de veiligheid te garanderen.
Hoe testen?
Voorlopig heeft VDAB nog geen aparte testomgeving voor deze API en moet je dus rechtstreeks op de live-omgeving testen vanuit je eigen systeem.
We geven hieronder een voorbeeld van een mogelijke zoekopdracht.