SG Developers Recommend Job
This endpoint is deprecated. Please do not use it for new projects. The documentation remains here for legacy API consumers.
Recommending a specific job to another person
Request with tokens
Sharing job postings among users is supported by the API. By using a POST with the /jobs/{jobDbId}/recommend endpoint, a job can be send to another person:
|
1 |
curl -i -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -X POST "https://api.softgarden.io/api/rest/v2/frontend/jobs/{jobDbId}/recommend?from={from}&to={to}&message={message}" |
with TOKEN being either a client access token or a user access token and {jobDbId} corresponding to the job that is to be shared. {from} and {to} must be the email addresses of the sender and the recipient respectively, {message} is self-explanatory in this context. If the recommendation already exists, nothing is done.
Request with basic authorization
As an alternative, you can use here the basic authorization method. Just write
|
1 |
curl -i -u "{clientId}:" -H "Content-Type: application/json" -X POST "https://api.softgarden.io/api/rest/v2/frontend/jobs/{jobDbId}/recommend?from={from}&to={to}&message={message}" |
{clientId} is the ID for your application to develop given to you by softgarden. The colon seen in the example is obligatory.
Path parameters
| Name | Description | Data Type |
|---|---|---|
| jobDbId | ID of the job to be shared | String |
Query parameters
| Name | Description | Data Type |
|---|---|---|
| from | Email address of sender. | String |
| to | Email address of receiver. | String |
| message | The text accompanying this recommendation. | String |
Response values
| Upon | Returned value | Description |
|---|---|---|
| success | void | There is no feedback to the user. If the recommendation is send or not cannot be determined, it is always just void. |
| error | 400 – BAD REQUEST | Sender or recipient email invalid |
| failure | 500 – INTERNAL SERVER ERROR | When an error appears while processing your request. |
| authorization error | 401 / 403 | See here for details. |