SG Developers Job information
| The target group for this API are 3rd party partners of softgarden that are integrating into the marketplace. This API is not suitable for building your own application form or job portal. Please use the FrontendAPIV3 for this purpose. |
Requesting job information
It is recommended to start the application process by obtaining the following information about the job:
- The job still allows to be applied to (a job could have been deactivated/deleted in the meantime)
- The job contains mandatory prescreening questions which have to be answered by the applicant
- Links to the privacy statements of the company
- The language of the job advertisement
- The nationality catalog values in the job’s language
Job Feed information
Usually, a Job Feed looks like this:
The job id (IdValue) in “PositionRecordInfo” is required to get information about the job and post the application.
The request using the id of the job feed example above would look like this:
|
1 |
GET https://jobdb.softgarden.de/jobdb/public/apply/external?jobid=12345678 |
Example Response (Success):
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 |
{ "jobId": 123456789, "jobTitle": "Product Manager", "jobLanguage": "en", "applyPossible": true, "dataSecurityLink": "https://productnextdemo.staging.softgarden.io/de/data-security", "questions": [{ "id": "8", "type": "YESNO", "label": "Are you willing to move to London?", "answers": [{ "id": "2900101", "label": "No" }, { "id": "2900100", "label": "Yes" }] }, { "id": "9", "type": "TEXT", "label": "What was your last position?" }, { "id": "10", "type": "TEXTAREA", "label": "Please describe the main responsibilities of your last position" }, { "id": "11", "type": "CATALOG", "label": "What is your favorite operational area?", "answers": [{ "id": "69892aa8-d656-4e96-b026-efa1200b8f9f", "label": "Product Design" }, { "id": "d1d89770-a2cd-41c5-bb75-7f5541200e08", "label": "Software Development" }, { "id": "0d7ccd47-46e5-4adb-9a88-aade6c2e3e89", "label": "Marketing" }] }, { "id": "-101", "type": "CATALOG", "label": "What is your preferred location for this job?", "answers": [{ "id": "2244", "label": "Grülingsstraße 10, Saarbrücken, 66113, Deutschland" }, { "id": "2245", "label": "Vollweidstraße 8, Saarbrücken, 66115, Deutschland" }, { "id": "2246", "label": "Kálmánstraße 15, Saarbrücken, 66113, Deutschland" }] }, "nationalities": [{ "id": "2800001", "label": "Afghan" }, { "id": "2800003", "label": "Albanian" }, { "id": "2800137", "label": "American" }, ... ], "timestamp": "2021-10-25T09:01:20.973Z", "companyName": "ACME Inc.", "companyId": "a6a8e42b-f3ef-410a-b823-36acf5e546c3", "location": { "geoLat": "49.2447042", "geoLong": "6.9941396", "geoName": "Grülingsstraße 10, 66113 Saarbrücken, Germany", "geoCountry": "Germany", "geoState": "Saarland", "geoCity": "Saarbrücken", "geoZip": "66113", "geoStreet": "Grülingsstraße 10" }, "additionalLocations": [ { "geoLat": "49.244611", "geoLong": "6.9954679", "geoName": "Kálmánstraße 15, 66113 Saarbrücken, Germany", "geoCountry": "Germany", "geoState": "Saarland", "geoCity": "Saarbrücken", "geoZip": "66113", "geoStreet": "Kálmánstraße 15" }, { "geoLat": "49.2529581", "geoLong": "6.9353122", "geoName": "Vollweidstraße 8, 66115 Saarbrücken, Germany", "geoCountry": "Germany", "geoState": "Saarland", "geoCity": "Saarbrücken", "geoZip": "66115", "geoStreet": "Vollweidstraße 8" } ] } |
Example Response (Error: Job inactive/apply not possible):
Error Codes:
ERROR_JOB_INACTIVE: The job is deactivated
ERROR_JOB_UNAVAILABLE: The job is more available/deleted
ERROR_POSTING_UNAVAILABLE: The job posting could not be found (technical error/data inconsistency)