Im Folgenden wird beschrieben, wie auf den Profession Service zugegriffen werden kann und welche Endpoints über die Schnittstelle (API) zur Verfügung gestellt werden:
Zugang
Der Profession Service ist öffentlich und ohne Authentifizierung über eine Schnittstelle (API) oder Webapplikation zugänglich:
Umgebung | API | Webapplikation |
|---|---|---|
PRODUKTION |
Für einen Zugang zu den TEST- und QUALITY-Umgebungen wenden Sie an datenmanagement(at)sdbb.ch.
Endpoints
Über folgende Endpoints können im Profession Service Daten bezogen werden (ab Version 2.0 der API):
| Kategorisierung | Endpoint | Beschreibung |
|---|---|---|
ExaminationSubject | ExaminationSubject | Liefert alle Informationen (Bezeichnungen, Abkürzungen, Codes) zu einem spezifischen Fach. Als Abfrageparameter muss der Dat-Code (Code für den Datenaustausch) des gewünschten Fachs mitgegeben werden. |
| ExaminationSubjects | Liefert die Informationen (Bezeichnungen, Abkürzungen, Codes) zu allen Fächern, die den möglichen Suchkriterien (searchString, changedSince) in einer bestimmten Sprache entsprechen. Der searchString sucht in den Feldern shortName[xx] und description[xx] der gewählten Sprache nach Übereinstimmungen. |
ProfessionExaminationSubject | ProfessionExaminationSubject | Liefert den vollständigen Fächerspiegel zu einem gewünschten Beruf, samt Gewichtungen und Rundungsregeln. |
ProfessionService | Profession | Liefert alle verfügbaren Angaben zu einem bestimmten Beruf (ohne Fächerspiegel). |
Professions | Liefert die gleichen Angaben wie der Endpoint "Profession", aber zu allen Berufen, welche den Kriterien gemäss den Suchparametern entsprechen. | |
ValidLenaProfession | Mit diesem Endpoint kann unter Angabe von Berufsnummer und Berufsvariante geprüft werden, ob auf diesem Beruf für das angegebene Jahr des Lehrbeginns Lehrstellen ausgeschrieben werden dürfen. | |
SearchLenaProfessions | Dieser Endpoint ist veraltet und sollte nicht mehr verwendet werden. |
Technische Informationen zu Swagger sind im OpenAPI Guide zu finden.
Kontakt
Datenmanagement Berufsbildung
datenmanagement(at)sdbb.ch