Wichtig: Die Assessment API ist nicht für BMS-Kunden gedacht. Sie richtet sich an Drittanbieter von Assessments(z. B. Test- oder Diagnostik-Tools), die ihr System mit softgarden integrieren möchten. Wenn du Interesse hast, Teil unseres Marketplaces zu werden, wende dich bitte an: https://softgarden.com/de/partnerprogramm.
Die Assessment API verbindet softgarden mit externen Anbietern. So kannst du z. B. Tests direkt aus softgarden heraus auswählen, Kandidaten einladen und Ergebnisse strukturiert zurückerhalten – ohne Medienbruch.
1) Was ist die Assessment API?
Die Assessment API ist eine Schnittstelle zwischen dem softgarden ATS und einem externen Assessment-Tool. Der Assessment-Anbieter stellt seine Endpunkte bereit; softgarden ruft diese auf, um Tests abzurufen, Kandidaten einzuladen, Ergebnisse zu erhalten und – falls nötig – Daten löschen zu lassen.
Wofür die Assessment API nicht gedacht ist:
Eigene Karriereseiten oder Bewerbungsformulare (dafür gibt es die Frontend API v3)
Datenexporte aus dem Backoffice
2) Für wen lohnt sich die Assessment API?
Für Assessment-Anbieter/Drittanbieter, die ihr Tool im softgarden-Ökosystem verfügbar machen möchten.
Nicht geeignet, wenn du lediglich Stellen anzeigen oder Bewerbungen einsammeln willst – dafür ist die Frontend API v3 vorgesehen.
3) Wie läuft ein Assessment über die API ab? (vereinfacht)
Tests abrufen: softgarden fragt beim Anbieter an, welche Tests verfügbar sind.
Einladung auslösen: Du wählst einen Test in softgarden; der Anbieter erhält die Einladung inkl. Kandidaten.
Update melden: Sobald das Assessment abgeschlossen ist, informiert der Anbieter softgarden über ein Update.
Ergebnisse abholen: softgarden ruft die Resultate beim Anbieter ab und zeigt sie in der Bewerbung an.
Datenlöschung (optional): Bei Bedarf veranlasst softgarden die Löschung der Daten beim Anbieter.
4) Rollen & Verantwortlichkeiten
Assessment-Anbieter: Stellt die notwendigen Endpunkte bereit und dokumentiert Authentifizierung sowie Datenformate.
softgarden: Bindet die Endpunkte an, zeigt Tests/Ergebnisse im ATS an und steuert den Ablauf.
HR-Team (du): Wählt Tests aus, stößt Einladungen an und nutzt die Resultate im Auswahlprozess – ohne zusätzliche Portale.
5) Sicherheit & Datenschutz (einfach erklärt)
Zugriffe sind geschützt (authentifizierte API-Aufrufe zwischen softgarden und dem Anbieter).
Datenminimierung: Es werden nur die für das Assessment nötigen Informationen übertragen.
Ergebnisse im Blick: Scores/Wertungen landen zentral in der Bewerbung – nachvollziehbar und revisionssicher.
6) Häufige Fragen (FAQ)
Q: Kann ich als Kunde die Assessment API selbst nutzen? A: Nein. Die API richtet sich an Drittanbieter. Als Unternehmen nutzt du die fertige Integration direkt in softgarden.
Q: Müssen Kandidaten ein extra Konto beim Anbieter anlegen? A: In der Regel nein – die Einladung kommt aus softgarden, der Test läuft beim Anbieter. Für Kandidat:innen ist das Handling möglichst nahtlos.
Q: Wo sehe ich die Ergebnisse? A: Direkt in der Bewerbung in softgarden – je nach Anbieter als Score/Status und ggf. mit verlinktem Detailbericht.
Q: Wir haben bereits einen Test-Anbieter – wie starten wir? A: Bitte verweise deinen Anbieter auf die softgarden Assessment API. Er stellt die Endpunkte bereit; wir koordinieren die Anbindung gemeinsam. Der Anbieter kann sich zwecks Prüfung einer Integration direkt an https://softgarden.com/de/partnerprogramm wenden.