Tutorial 1 - Creating a Job
We will give a short introduction to usage of our ATS-API by providing a tutorial in which we:
Create and preview a job
Publish the previously created job
We will demonstrate how to create and update a job using TypeScript.
1. Create and preview a job
The /job/createOrUpdateJob endpoint allows you to create a new job listing or update an existing one. To use this endpoint, you need to provide the appropriate access_token obtained from the authentication process.
To Add a job, we use the createOrUpdateJob operation which will post an object to create a job. To preview the job before publishing, the isPublished property must be set to false (default). In this case the server will return a job object containing a previewUrl.
As seen in the Swagger Definition, the createOrUpdateJob endpoint requires two data:
a unique identifier to this job (see details in Reference: job # sourceId)
the job details (see details in Reference: job # params)
(For complete documentation of the endpoint, please refer to the Swagger Definition that is auto-generated and up-to-date!)
Here's an example of how to create or update a job using TypeScript and node-fetch:
On success, the response also contains the webPreviewUrl to view the job to check the contents.
(Note that because we created the job without the isPublished param, which will default to false. However, we can still preview the job even if it is not publicly available to the users yet.)
2. Publish the previously created job
To finally publish the job, the isPublished param is set to true.
Which would result in a response output like:
(Note that there is no webPreviewUrl any more, but only the final webUrl of the published job.)