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) 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.
5) 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).
6) 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: Kann ich interne und externe Jobs trennen? A: Ja. Kanäle lassen sich gezielt ansteuern (z. B. „nur externe“).
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).