Public
Documentation Settings

ExaminLab

Online testing platform to accurately assess employees and candidates’ competencies in a fast and effective way.

ExamInLab provides organizations with Computerized Adaptive Tests (CATs), namely computer-based tests that adapt the difficulty and severity of each question to each examinee’s ability level. After the examinee provides the very first reply, a score is calculated. By getting it correct, the examinee gets a tougher item, while by getting it incorrect, the examinee gets an easier item.

Create you profile now on https://www.arca24.com/examinlab/

Our API is organized around REST. You can have ExamInLab integrated in your platform using our API to access endpoints, get and post information.

All responses are in JSON format.

The errors are expressed using HTTP response status codes:

200: ok 400: Bad Request - check the data you sent 401: Unauthorized - The access token has expired or the credentials are incorrect 50x: Server error responses - please contact us

Token

ExaminLab's API use Oauth2 authentication to ensure data integrity.

The data you need in order to get the access token and use all the methods of the ExaminLab API are:

  • grant_type: it is always "password";
  • client_id: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • client_secret: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • username: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • password: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • scope: it is always "employer"

Once you have retrived yor access token you need to put it inside the attribute Authorization of the other calls you need to perform, alongside with your client_secret:
Authorization: Basic client_secret, Bearer access_token

POSTCreate an access token

https://examinlab.arca24.careers/ws/v.1/token

Using this method you can retrive the access token you need in order to use all the other methods of the ExaminLab API.

Input
  • grant_type*: it is always "password";
  • client_id*: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • client_secret*: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • username*: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • password*: you can find this value after registering in ExaminLab in the "API Credentials" area;
  • scope*: it is always "employer"
Output
  • access_token
  • expires_in
  • token_type
  • scope
  • refresh_token
HEADERS
Content-Type

application/json

Accept

application/json

Bodyraw
{
    "grant_type": "password",
    "client_id": "",
    "client_secret": "",
    "username": "",
    "password": "",
    "scope": "employer"
}
Example Request
curl
curl --location 'https://examinlab.arca24.careers/ws/v.1/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
    "grant_type": "password",
    "client_id": "",
    "client_secret": "",
    "username": "",
    "password": "",
    "scope": "employer"
}'
Example Response
No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers

GETCheck if the access token is still valid

https://examinlab.arca24.careers/ws/v.1/token

This method simply returns an HTTP response status codes based on the data sent in the header.

Output
  • 200: if your access token is still valid
  • 401: if your access token is not valid
HEADERS
Content-Type

application/json

Accept

application/json

Authorization

Basic , Bearer

Example Request
curl
curl --location 'https://examinlab.arca24.careers/ws/v.1/token' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Basic , Bearer '
Example Response
No response body
This request doesn't return any response body
No response headers
This request doesn't return any response headers