BerufeNet

Die Anbindung an die BerufeNet API scheint nicht 100% offiziell zu sein und zum Teil Reverse Engineered zu sein. Dadurch ergeben sich einige Einschränkungen:

Access Key

Im Entwickler Repository wird der notwendige Access Key (X-API-Key) und eine Anleitung genannt wie man diesen erhält. Während der Projektlaufzeit kam es bereits zu einer Änderung weshalb für einen Zeitraum der Teil unseres Services nicht funktionierte. Dabei wurde der angegebene Access-Key im Repository erst Wochen später aktualisiert. Derzeit lautet er: clientId: infosysbub-berufenet. Dieser kann wie folgt von der Seite der Arbeitsagentur ausgelesen werden:

1. Aufruf der Webseite: https://web.arbeitsagentur.de/berufenet/ergebnisseite/berufe-a-z
2. Netzwerkkonsole öffnen
3. Eine beliebige Anfrage stellen, z.B. Suche nach Informatiker
4. Beim Anfrage-Header des GET-Requests den X-API-Key auslesen.
5. In den Umgebungsvariablen zu unserem Service die Variable BERUFENET_CLIENT_SECRET anpassen.

Fehlende Schemata Spezifikation

Für die BerufeNet API konnte keine Schemata-Spezifikation gefunden werden. Auch nicht in den im Entwickler-Repository enthaltenen OpenAPI Spezifikationen. Entsprechend können wir weder die Typsicherheit in unserem Code gewährleisten, noch auf der zur Verfügung gestellten Swagger-Seite ein Schema-Spezifikation angeben. Lediglich für getJobsBySearchString haben wir eine reverse-engineered. Auf Grund der Komplexität der anderen Endpunkte haben wir von weiteren Schemata abgesehen.