Worum geht’s?
Mit der Frontend API v3 kannst du auf deiner Karriereseite Stellenanzeigen aus softgarden anzeigen und Bewerbungen digital einsammeln – direkt in deinem Look & Feel.
1) Was ist die Frontend API v3?
Die Frontend API v3 ist eine Schnittstelle von softgarden, über die Job-Detailinformationen bereitgestellt werden. Damit kannst du:
Stellenlisten anzeigen
Jobdetails abrufen
Bewerbungen anlegen und abschließen
Sie ist dafür gedacht, deine eigene Karriereseite mit softgarden zu verbinden, ohne dass Nutzer deine Seite verlassen müssen.
Wofür die Frontend API v3 nicht gedacht ist:
Bearbeitung von Bewerbungen
Export von Bewerberdaten
Tiefe Systemintegration
Die API ist der „öffentliche Eingang“ in den Bewerbungsprozess.
2) Was kannst du damit machen?
Jobs anzeigen: Eigene Jobliste/Jobsuche auf deiner Website mit Filter- und Sortierfunktionen (z. B. Standort, Bereich).
Jobdetails ausspielen: Titel, Beschreibung und Bewerbungslink in deinem Design darstellen.
Bewerbungsformular einbetten: Kandidaten geben ihre Daten ein (Basisdaten, Fragen, Anhänge) – ohne deine Seite zu verlassen.
Datei-Uploads: Lebenslauf, Zeugnisse oder Profilbild hochladen.
Self-Service für Bewerbende (optional): Bewerberkonto anlegen und Bewerbungen verwalten.
Ergebnis: Ein durchgängiger, markenkonformer Prozess mit weniger Absprüngen und einer klareren Candidate Experience.
3) Wann lohnt sich die Frontend API v3?
Du willst volle Kontrolle über UX & Design deiner Karriereseite.
Deine IT oder Web-Agentur kann einfache API-Aufrufe einbauen.
Du möchtest eine durchgehende Candidate Experience auf deiner eigenen Homepage bieten – ohne Absprung zu softgarden.
Nicht ideal, wenn du keine Entwicklungsressourcen hast. In diesem Fall sind Einbettungen (direkte Verlinkung zu softgarden) oder Widgets (iFrame) oft schneller umzusetzen.
4) Erstellen einer Client ID zum Aufrufen der API v3
Um auf die API v3 zuzugreifen musst du dir oder deiner Agentur zunächst eine ClientID erstellen
Gehe hierzu in softgarden zu: "Einstellungen" -> "Zusätzliche Funktionen" -> "Integrationen"
Unter dem Punkt "softgarden API" kannst du einen Namen für die ClientID vergeben und klickst auf "Erstellen"
Der Wert in der Spalte "ClientID" kann genutzt werden, um die API v3 aufzurufen
Hinweis: Für die Nutzung der API v3 ist lediglich eine public ClientID erforderlich. Ein Secret wird nicht benötigt.
5) So läuft eine Bewerbung per API (vereinfacht)
Jobkanal abrufen: Welche Jobs sollen angezeigt werden?
Jobs laden & anzeigen: Liste und Detailseiten auf deiner Homepage darstellen.
Bewerberkonto anlegen (oder bestehendes nutzen): Ohne Account keine Bewerbung. Das Konto kann sichtbar (Self-Service) oder „implizit“ (mit Platzhalter-Passwort) angelegt werden.
Bewerbung starten: Eine „Entwurfsbewerbung“ (Draft) wird erzeugt.
Daten und Anhänge speichern: Formularfelder, Pflichtfragen und Dokumente hochladen.
Bewerbung final einreichen: Der Draft wird abgeschlossen und im ATS sichtbar.
Wichtig: Ab dem Schritt „Bewerbung starten“ arbeitet die API im Kontext des Bewerbers. Das schützt den Prozess und die Daten.
6) Was braucht HR/IT dafür?
Design/UX-Entscheidung: Welche Felder, Sprachen und Pflichtfragen sollen angezeigt werden?
Technische Ressourcen: Web-Agentur oder Inhouse-Entwickler, die API-Antworten darstellen und Formulare anbinden können.
Recht/Datenschutz: Datenschutzhinweise und Einwilligungstexte bereitstellen.
Datei-Regeln: Maximalgrößen und Dateitypen definieren (Empfehlung: PDF/DOCX, ≤ 10 MB, 3–5 Anlagen reichen meist).
7) Häufige Fragen (FAQ)
Q: Bewerben sich Kandidaten mehrfach mit derselben E-Mail? A: Pro E-Mail-Adresse gibt es ein Bewerberkonto. Existiert bereits ein Account, muss sich die Person einloggen (Passwort-Reset möglich). Implizite Kontoerstellung funktioniert nur, wenn noch kein Account existiert.
Q: Muss ich sensible Daten selbst vorhalten? A: Nein. Die Website zeigt Formulare an, speichert die Daten aber nicht dauerhaft – sie werden direkt an softgarden übergeben.
Q: Wie binde ich Pflichtfragen ein? A: Die Fragen werden pro Job geliefert und im Formular angezeigt (Pflicht oder optional).