Test Report


You can get a test report using following API endpoint:

 https://api.hackerearth.com/recruiter/v1/tests/test_report/

Authentication

The client authentication is done using your unique client_id and client_secret.

You can refer to your Dashboard settings, for client_id and client_secret under API details.

client_id

Type: String

Description: client_id is a 67 character random key that serves as an identification for a particular client and must be provided when communicating with the API as a parameter to the API endpoint.

Example: d8a20ae8e475209er4b1faa72ede88a174423cc2029c.api.hackerearth.com

client_secret

Type: String

Description: client_secret is a 40 character random key that serves as an identification for a particular client and must be provided when communicating with the API as a parameter to the API endpoint.

Example: 2b0ff29f4f8751487540604cdab5611e6135f41c


Making requests

Test reports are accessible only for published test.

client_id, client_secret and test_id are the required parameters for making request to this API endpoint.

All the requests to the API must be made using POST request method.

client_id and client_secret are explained above.

test_id

Type: Integer

Description: test_id is an unique integer for your test.
Refer advance settings section under test settings for test_id.

Example: 5841

Sample request using python

#!/usr/bin/env python

import requests

CLIENT_ID = "d8a20ae8e475209e0eb1faa72ede88a174423cc2029c.api.hackerearth.com"
CLIENT_SECRET = "2b0ff29f4f8751487450604cdab5611e6135f41c"
TEST_ID = 53

payload = {
    'client_id': CLIENT_ID,
    'client_secret': CLIENT_SECRET,
    'test_id': TEST_ID
}
r = requests.post("https://api.hackerearth.com/recruiter/v1/tests/test_report/", data=json.dumps(payload))
print r.json()

Using cURL

curl --data '{"client_id":"d8a20ae8e475209e0eb1faa72ede88a174423cc2029c.api.hackerearth.com","client_secret":"2b0ff29f4f8751487450604cdab5611e6135f41c","test_id":20}' https://api.hackerearth.com/recruiter/v1/tests/test_report/


Response

Response returned will be in JSON format.

Sample response

{
    "report": {
        "completed_test": [
            {
                "start_datetime": "20-01-2013 04:00:44 +0000",
                "resume": "",
                "candidate_name": "foo bar",
                "candidate_total_score": 4,
                "email": "foo@bar.com",
                "candidate_id": 1966,
                "finish_datetime": "20-01-2013 07:02:26 +0000",
                "percentage": 80,
                "time_taken": "0:00:00"
            },
        ],
        "currently_taking": [
            {
                "start_datetime": "15-02-2015 10:20:01 +0000",
                "resume": "",
                "candidate_name": "alice",
                "candidate_total_score": 175,
                "email": "alice@bob.com",
                "candidate_id": 166980,
                "percentage": 100,
                "time_taken": "15:42:53"
            }
        ],
    },
    "message": "Request successful",
    "ecode": [],
    "emessage": [],
    "mcode": "SUCCESS"
}

mcode

Type : String

Description: Message code abbreviated as mcode.

message

Type: String

Description: A message for user regarding the success of request.

message and mcode are related to each other according to the following table:

mcode message
SUCCESS Request successful
FAILED Request failed

ecode

Type: List

Description: Error codes abbreviated as ecode.

emessage

Type: List

Description: A message explaining the error occurred during request processing.

emessage and ecode are related to each other according to the following table:

ecode emessage
AUTHFAILED Authentication Failed
ARGMISSING Request argument missing
MUSTBEINT Test ID must be integer
TESTNOTFOUND Test not found
NOREPORT No report exist.
LIMITEXCEEDED Client exceeded its request limit. Please contact support@hackerearth.com.

report

Type: Dictionary (JSON)

Description: The report dictionary will contain two more key value pair that is currently_taking and completed_test. These keys will have values as a list (array) of candidate report who are currently taking the test and have already completed the test respectively as shown above.


Errors (Mishandled API responses)

If you have provided wrong client_id or client_secret, the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
         "AUTHFAILED"
    ],
    "emessage": [
        "Authentication Failed"
    ],
    "mcode": "FAILED"
}

If mandatory POST arguments are not provided, the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
        "ARGMISSING"
    ],
    "emessage": [
        "Request argument missing: 'test_id'"
    ],
    "mcode": "FAILED"
}

If the type of test_id is not integer, then the JSON response returned will look like:

{
"message": "Request failed",
"ecode": [
    "MUSTBEINT"
],
"emessage": [
    "Test ID must be integer"
],
"mcode": "FAILED"
}

If wrong test_id is provided or the test has already been deleted, then the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
        "TESTNOTFOUND"
    ],
    "emessage": [
        "Test not found"
    ],
    "mcode": "FAILED"
}

If user is not authorized to access the test, the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
        "ACCESSERROR"
    ],
    "emessage": [
        "You are not authorized to access this feature. Please contact support@hackerearth.com."
    ],
    "mcode": "FAILED"
}

If the API request limit has exceeded, the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
        "LIMITEXCEEDED"
    ],
    "emessage": [
        "Client exceeded its request limit. Please contact support@hackerearth.com."
    ],
    "mcode": "FAILED"
}

If no candidates have taken the test, then the JSON response returned will look like:

{
    "message": "Request failed",
    "ecode": [
        "NOREPORT"
    ],
    "emessage": [
        "No report exist."
    ],
    "mcode": "FAILED"
}

If any other issue occurred do reach us out at api@hackerearth.com

Notifications
View All Notifications

?