Getting Started

Welcome to Recruitment Manager API documentation.

If you notice any problems using this API, please contact support@recman.no


How to use our documentation

The Recruitment Manager documentation is split into different categories, which you’ll find on the left side of this page.

For each category, you’ll find all the details on how to retrieve and modify data in your Recruitment Manager account.

In most cases, the categories will have different pages to help you along the way. Here are some explanations on what you can expect to find on these pages:

Retrieve Data

On the GET page, you’ll find details on how to retrieve and view data from your Recruitment Manager account. Here you’ll usually find:

A list of all available and required fields for this scope will be located on the reference pages.

Insert, Update and Delete

These pages will mainly give you some quick details and few code-examples on how to insert, update and delete data in your Recruitment Manager account. These examples are built to help you understand how to use the details you’ll find on the reference pages.

Our examples are always shown in PHP or JSON. You’re free to use the scripting language you prefer.

Reference

The reference guide pages will show you all details on how to insert, update and delete data in your Recruitment Manager account. This page will mostly start with some details about the scope, available operations and the URL to use. Underneath each scope details you’ll usually find a list of all available fields.

The fields-list will let you know which fields that are required, what kind of format you will need to use and in some cases details on where to find the data that is required.

If the scope has fields that are objects (fields with subfields) you’ll find details about the field and each subfield that is available beneath the field list.


Obtaining an API-key

New API-keys can be generated in the System Settings-page in your Recruiment Manager account ( System Settings -> Database -> API -> Create). You will have to be a system administrator to be able to view or create an API-key.

Once created, you will have to add access to your API-key, deciding which modules it should have access to, and which operations that are allowed.

Always limit your access to only contain the modules and operations you need. Especially if you share your API-key with external developers.

Note!

Please note that the API has a maximum of 200 loads per day (reset at midnight) for free. Any lookup after this will cost 0,09 kr per lookup. We therefore recommend to cache your feed in your own system, in order to avoid the lookup limit of 200.

Caching

One solution to restrict the number of requests (loads per day) is to download the json-file, and time stamp it. A script can check the time stamp periodically, and once the time exceeds a set limit, the system fetches a new file.

Security

Our API does not support “Access-Control-Allow-Origin”. As this would basically mean that any client-side operation would expose your API-key, we have decided not to enable this feature.