Competent-data afnemen met Competent 2 API

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.

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.

Je mag de Competent 2 API gebruiken, na het ondertekenen van een samenwerkingsovereenkomst.

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.

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

Meer info over de opbouw van beroepscompetentieprofielen

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

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.

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.

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.

• Bestand

  Voorbeeld Competent 2 API (56.3 KB)