Welcome to You Recruit Posting integration!

How Job posting works

We have added this page to give you as a site developer, a summary introduction on how posting a job to your website from You Recruit normally works.
We hope the API information below will provide you with enough information to begin your integration project with the You Recruit system.
For this exercise, Let's assume that your website is named http://www.yoursite.com

Are you using Wordpress?

Please Note, If you are using a wordpress platform, we can recommend you a module where we have prepared an API integration.

Need help with your database setup in PHP?

Also, if you are using PHP and have not created any database structure, we can provide you a basic structure of the import module and database that you can modify for your own needs. If required, please contact us at support@yourecruit.com.

Sending a job

This usually happens in two possible ways, based on your preference,
(Version a) HTTP POST, Version b) via XML or Version c) via JSON):

Version a) Via HTTP POST

YouRecruit will send a HTTP POST request to a script on your website.
(for example http://www.yoursite.com/jobload/get_job.php)
This http request always contains only one job and is usually a standard HTTP POST with several values contained within the feed.
For the purposes of viewing the structure of our post (View HTTP POST example feed).

Version b) Via XML

This is similar to the HTTP POST option as per version a) with the main modification being that the content is not in HTTP POST values, but is XML content with all job details contained within (view XML example here).

On your website, the get_job.php script will do the following:

1. Check if the username and password login details are correct (to keep the database data secure)
2. Check if all required information is present (job_id, ref, ...)
3. Check if the current job exists in your internal database and insert or update it to the database.

The script always returns the XML response in a specified format either with information that the job was successfully uploaded (view success example) or that there was an error (view error example).
There can be several fields added into the job detail, if and when this is required by the client. Most frequently these customisations are found to be in the Locations or the Categories. These customisations should be agreed with the client before we proceed with development.
Other specific fields can be decided after the basic integration is completed.
There are several IDs in the feed (category_id, location_id). These are specific for your client. You will be able to access these details in the private resources area when integration development begins and you receive a username and password.

Version c) Via JSON

Works in exactly the same way as XML. The only difference is sending and receiving the data in JSON format (not in XML).

Deleting a job

The delete script is very similar to the previous one, but it is for removing a job from the website (for example http://www.yoursite.com/jobload/delete_job.php). The delete script requires the values login_username, login_password and job_id (view example). It removes the job from the website. The script returns the XML response which indicates if the job was deleted or not (view example).

Feedback function

An important part of the integration is the feedback function. This returns an JSON or XML output of all active jobs on the website. It requires the same username and password in the earlier requests.
For example: http://www.yoursite.com/jobload/feedback.php?username=joe.black@yoursite.com&password=bbb (login details might be avoided completely or can be in POST request). Please view the JSON feedback example or XML feedback example.

It is a minor addition to create this script, but it will save time when we need to check for jobs that were not correctly deleted from the site, and helps greatly with diagnosing problems without having to raise support queries with your support team in the future. We run this process daily after midnight so it should not create any load issues on your server.

Please note we recommend all communication takes place in utf-8.

Job Fields Description

This table is a list of the main fields that are normally catered for when setting up feed integration between your site and You Recruit, contained within this table are also private resources for development partners once integration begins.
Once again, we are able to customise these fields based on client requirements depending on scenario.