Executing a job search

Executing a job search

Request with tokens

The endpoint /jobboards/{channelID}/jobs allows for search operations.

with TOKEN being either a client access token or a user access token and {channelID} corresponding to the desired channel. The other two query parameters define the search. They may be empty respectively left out. When using a geolocation to limit the result, please take notice of the following. The geolocation refers to the position, not to the job advertisement rubrification. And of course the geolocation has to be set in the positions data.

The system will attempt to localize the search’s results, the locale is extracted from the header. In the curl example you can manipulate the header by adding -H “Accept-Language:{locale}”, whereat locale can be en, de and so on.

Request with basic authorization

As an alternative, you can use here the basic authorization method. Just write

{clientId} is the ID for your application to develop given to you by softgarden. The colon seen in the example is obligatory.

Path parameters

Path parameters

Name	Description	Data Type
channelID	ID of the channel to search through.	String

Query parameters

Name	Description	Data Type	Default Value
search	A string with the search content.	String	empty string
geoLocation	Demanded geographic location, format ‘LatitudeAsRealNumber::LongitudeAsRealNumber::DistanceInKilometers‘. For more information see Wikipedia or a a tool for determining such a geotag. An example would be 52.520014::13.373006::50 for a radius of 50 kilometers around the German Bundestag building in Berlin. Additional job locations are also considered when this parameter is supplied.	String	empty string

Response values

Upon	Returned value	Description
success	JSON-encoded JobSearchResult-object	Results of the search.
failure	500 – INTERNAL SERVER ERROR	When an error appears while processing your request.
authorization error	401 / 403	See here for details.

Example return value: