Mandatory Prescreening Questions of a Job
You can define as many mandatory prescreening questions as you wish in the jobposting wizard that have to be answered by the applicant during the application process. This endpoint provides you these questions. For doing so the jobDbId of the job is required which you can take from the JobDTO. The possible question types are TEXT, TEXTAREA, YESNO and CATALOG. Depending on the type you should design the UI of your application form to get the answer to each type from the applicant and submit it back to the API.
The types YESNO and CATALOG additionally contain a list of possible answers that are used to provide the response.
HTTP-Method
GET
Path
/api/rest/v3/frontend/jobs/{jobDbId}/questions
Authentification
Client Token or Basic Authorization
Path Parameter
jobDbId
Query Parameter
-none-
Responses
Action | Response | Description |
---|---|---|
success | see example call | |
authorization error | 401 / 403 | See here and here for details. |
Example call with curl and basic authorization
1 |
curl -i -u "ab7gda25-2555-be-9e30-54ft928cce27:" -H "Content-Type: application/json" -X GET "https://api.softgarden.io/api/rest/v3/frontend/jobs/4711/questions" |
Repsonse:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
[ { "id" : 11019, "question" : "Free text", "type" : "TEXT", "answerCatalog" : null }, { "id" : 11020, "question" : "Free text textarea", "type" : "TEXTAREA", "answerCatalog" : null }, { "id" : 11021, "question" : "Yes or No", "type" : "YESNO", "answerCatalog" : [ "yes", "no" ] }, { "id" : 11022, "question" : "Catalog", "type" : "CATALOG", "answerCatalog" : [ "Answer 1", "Answer 2", "Answer 3" ] } ] |