SG Developers Resolving Catalog Values
To request the possible values for a catalog you need two things. The language in which the values should be resolved in ISO 639-1 notation as well as the catalogType of the catalog you need the values of. Please have a look at the attached table that lists all available catalogTypes depending on the DTO used in different endpoints.
JobDTO
| Field name | catalogType |
|---|---|
| jobCategories | JOB_CATEGORY |
| audiences | AUDIENCE |
| employmentTypes | EMPLOYMENT_TYPE |
| workTimes | WORKING_HOURS |
| industries | POSITION_INDUSTRY |
| workExperiences | WORK_EXPERIENCE |
ApplicationProfileDTO
| Field name | catalogType |
|---|---|
| academictitle | ACADEMIC_TITLE |
| experiences.industry | EXPERIENCE_INDUSTRY |
| experiences.careerLevel | CAREER_LEVEL |
| experiences.companySize | COMPANY_SIZE |
| languages.skill | LANGUAGE_SKILL |
In addition to the language skill you can get the catalog of all possible languages that can be picked for adding a language skill with the catalogType LANGUAGE.
HTTP-Method
GET
Path
/api/rest/v3/frontend/catalogs/{catalogType}
Authentification
Client Token or Basic Authorization
Path Parameter
catalogType
Query Parameter
locale
Responses
| Action | Response | Description |
|---|---|---|
| success | see example call | |
| authorization error | 401 / 403 | See hier and hier for details. |
| not found | 404 | The requested catalogType does not exist |
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/catalogs/WORKING_HOURS?locale=DE" |
Response:
|
1 2 3 4 5 |
{ "799eb9d2c0bc4e7490fde05f847b331a" : "Teilzeit", "137caf67764c4b63b0272895af1704b0" : "Vollzeit", "ebc0523b259945e3b633d88428a3ce7a" : "Freie Mitarbeit/Projektmitarbeit" } |