Developers Bewerber und Job
Bevor sie den Bewerbungsprozess beginnen, können Sie überprüfen ob sich ein Bewerber bereits auf einen Job beworben hat und wie die ID dieser Bewerbung gegebenenfalls aussieht. Grundsätzlich gilt nämlich, dass es pro Bewerberkonto und Job nur eine Bewerbung geben kann, auch wenn eine Bewerbung zurückgezogen wurde. Für beide nachfolgend beschriebenen Anfragen benötigen sie neben der jobDbId des Jobs auch ein User Access Token für das Bewerberkonto, welches Sie wie hier beschrieben generieren können.
Hat sich der Bewerber bereits auf einen Job beworben?
HTTP-Methode
GET
Pfad
/api/rest/v3/frontend/jobs/{jobDbId}/applied
Authentifizierung
User Access Token
Path Parameter
jobDbId
Query Parameter
-keine-
Responses
| Ereignis | Rückgabewert | Beschreibung |
|---|---|---|
| success | true oder false | |
| error | 404 – JobPosting not fount for jobId X | Für diesen Job gibt es keine Stellenanzeige |
| error | 403 – JobPosting not accessible for jobId X | Der Benutzer hat keinen Zugriff auf die Stellenanzeige (z.B. weil Sie auf dem internen Kanal geschaltet wurde, der Benutzer aber kein interner Benutzer ist). |
| error | 410 – JobPosting inactive for jobId X | Die Stellenanzeige wurde deaktiviert. |
| error | 404 – { “code”: “get_project_error”, “message”: “Project for jobId X not available” } | Zu dieser jobDbId wurde kein Job gefunden |
| error | 404 – { “code”: “get_project_error”, “message”: “Project for jobId X not accessible” } | Es wurde zwar ein Job gefunden, der Benutzer hat aber keinen Zugriff. (z.B. wird versucht auf einen Job eines anderen Unternehmens zuzugreifen). |
| authorization error | 401 / 403 | Siehe hier und hier für Details. |
Beispielaufruf mit curl und user access token
|
1 |
curl -i -H "Authorization: Bearer 31cb2exx-001e-4b59-babc-f0815tdad47d" -H "Content-Type: application/json" -X GET "https://api.softgarden.io/api/rest/v3/frontend/jobs/4711/applied" |
Antwort:
|
1 |
true |
Wenn ja, wie lautet die Bewerbungs-ID?
HTTP-Methode
GET
Pfad
/api/rest/v3/frontend/jobs/{jobDbId}/application
Authentifizierung
User Access Token
Path Parameter
jobDbId
Query Parameter
-keine-
Responses
| Ereignis | Rückgabewert | Beschreibung |
|---|---|---|
| success | ID der Bewerbung als String | |
| error | 404 – JobPosting not fount for jobId X | Für diesen Job gibt es keine Stellenanzeige |
| error | 403 – JobPosting not accessible for jobId X | Der Benutzer hat keinen Zugriff auf die Stellenanzeige (z.B. weil Sie auf dem internen Kanal geschaltet wurde, der Benutzer aber kein interner Benutzer ist). |
| error | 410 – JobPosting inactive for jobId X | Die Stellenanzeige wurde deaktiviert. |
| error | 404 – { “code”: “get_project_error”, “message”: “Project for jobId X not available” } | Zu dieser jobDbId wurde kein Job gefunden |
| error | 404 – { “code”: “get_application_error”, “message”: “No application was found for job X” } | Keine Bewerbung des Bewerbers auf diesen Job gefunden |
| authorization error | 401 / 403 | Siehe hier und hier für Details. |
Beispielaufruf mit curl und user access token
Erfolgreiche Anfrage.
|
1 |
curl -i -H "Authorization: Bearer 31cb2exx-001e-4b59-babc-f0815tdad47d" -H "Content-Type: application/json" -X GET "https://api.softgarden.io/api/rest/v3/frontend/jobs/4711/application" |
Antwort:
|
1 |
76505as-99b5-45dgd-aaef-b59e5d4xxa46 |
Beispielaufruf mit curl und user access token
Es existiert keine Bewerbung.
|
1 |
curl -i -H "Authorization: Bearer 31cb2exx-001e-4b59-babc-f0815tdad47d" -H "Content-Type: application/json" -X GET "https://api.softgarden.io/api/rest/v3/frontend/jobs/4712/application" |
Antwort:
|
1 2 3 4 |
{ "code": "get_application_error", "message":"No application was found for job 4712" } |