First Step – Performing Authentication
The Resumes API enables third party companies to search for resumes, look through the full resume views and download resumes at eFinancialCareers. This section will outline the procedure to authenticate to Resumes Service of eFinancialCareers.
You will need an email and a password for searching and viewing resumes. That data is needed to identify you in the system. If you have these then you are set to continue.
Authentication Flow
Step One – Authorization with User
To authorize, send an HTTP POST request to the following URL:
POST https://auth.efinancialcareers.com /v1/recruiter-service/token
The authentication URL is different for Pilot:
POST https://auth.pilotaws.efinancialcareers.com/v1/recruiter-service/token
Mandatory HTTP headers
Content-Type: application/json
And supply this JSON in the HTTP request body with your credentials:
{
"apiKey": "apiKey",
"password": "password”
}
Example of response:
{
"token": "522c3c4bd036a69db428ce4274745e9d",
"jwtDto":
{
"access_token": " eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZWNydWl0ZXJJZCI6Im9QbkNBZW11bnpkcXYxMFEiLCJzdWIiOiJzZXJ2aWNlUmVjcnVpdGVyQG1haWxpbmF0b3IuY29tIiwiY2xpZW50SWQiOiI4ZWVQa0ltWk82VHVtMTFHIiwidXNlcl9uYW1lIjoic2VydmljZVJlY3J1aXRlckBtYWlsaW5hdG9yLmNvbSIsInJvbGVzIjpbIkFETUlOSVNUUkFUT1JfX1JPTEUiLCJSRUNSVUlURVJfU0VSVklDRSIsIlJFQ1JVSVRFUl9fUk9MRSIsIlRFQU1fQURNSU5JU1RSQVRPUl9fUk9MRSJdLCJpc3MiOiIzTVZHOWlmbUFLQ0hJU2JhVHpDcm5BbHdJWFN2ZVpSRkZ6UmppdlEueGhXOFNYNXVFVjlYZGVPVWk3U2pTVVIwaWRzSzdjYTh5UllIWGpab3EzRmpjIiwiY3VzdG9tX3RhZ3MiOnsibG9jYWxlIjoiZW4ifSwiYXV0aG9yaXRpZXMiOlsiUkVDUlVJVEVSX1NFUlZJQ0UiLCJSRUNSVUlURVJfX1JPTEUiLCJURUFNX0FETUlOSVNUUkFUT1JfX1JPTEUiLCJBRE1JTklTVFJBVE9SX19ST0xFIl0sImNsaWVudF9pZCI6ImVmYyIsImF1ZCI6Imh0dHBzOi8vcWEtZGhpLmNzNzcuZm9yY2UuY29tL2VmaW5hbmNpYWxjYXJlZXJzIiwic2NvcGUiOlsicmVjcnVpdGVyX3NlcnZpY2UiXSwiZXhwIjoxNzEzMzM5NjA1LCJqdGkiOiI4Y2M3MjIwYS1iNmQxLTQ2MzQtOWQ4Yi1hMDAzMDY0ODNmY2QifQ.pswOo6FWAor1CySsDpsBBPDwUg3FXLiSpd92PDIOdiOquF1AMgKiAsd262yRdnX8hkrekuYfcyf45V5LjSgu-Dl6T_EaqPsfJVRQ-rnJkuQyMQMZ1KNS-liLucKLZOM663dwaqxCP_kQ7DhM5RDpW0MDzGHuV-xjz_61xvmWaqRVCG6x0r1CqSXCdzVqdV4neudJuMaGM_MKi3PfHqKsENZ-nraQ5CQjyZ25eHLWss1p3GEhNxAm3IRsYbDZf_vFl66raGcwUizGjHkZc_npteF88TTmw4Vqzlyz8-T8St96IwsmbF5cf9bp6xnNzTrMDvB_3OOP0CzTepAGcz0-4Q",
"token_type": "bearer",
"refresh_token": "refresh token",
"expires_in": 86399,
"scope": "recruiter_service",
"roles": [ "roles" ],
"jti": " jti”
}
}
Where:
token - access token for additional API search requests (contact jobseeker, download resume, get resume view, location service request, retrieve dictionary values
access_token - access token for resume API search
Step Two
For additional requests:
Your HTTP authorization header should contain the token received after your initial login as described in step one above.
For resume API search:
Your HTTP authorization header should contain the token the access_token received after your initial login as described in step one above.
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJyZWNydWl0ZXJJZCI6Im9QbkNBZW11bnpkcXYxMFEiLCJzdWIiOiJzZXJ2aWNlUmVjcnVpdGVyQG1haWxpbmF0b3IuY29tIiwiY2xpZW50SWQiOiI4ZWVQa0ltWk82VHVtMTFHIiwidXNlcl9uYW1lIjoic2VydmljZVJlY3J1aXRlckBtYWlsaW5hdG9yLmNvbSIsInJvbGVzIjpbIkFETUlOSVNUUkFUT1JfX1JPTEUiLCJSRUNSVUlURVJfU0VSVklDRSIsIlJFQ1JVSVRFUl9fUk9MRSIsIlRFQU1fQURNSU5JU1RSQVRPUl9fUk9MRSJdLCJpc3MiOiIzTVZHOWlmbUFLQ0hJU2JhVHpDcm5BbHdJWFN2ZVpSRkZ6UmppdlEueGhXOFNYNXVFVjlYZGVPVWk3U2pTVVIwaWRzSzdjYTh5UllIWGpab3EzRmpjIiwiY3VzdG9tX3RhZ3MiOnsibG9jYWxlIjoiZW4ifSwiYXV0aG9yaXRpZXMiOlsiUkVDUlVJVEVSX1NFUlZJQ0UiLCJSRUNSVUlURVJfX1JPTEUiLCJURUFNX0FETUlOSVNUUkFUT1JfX1JPTEUiLCJBRE1JTklTVFJBVE9SX19ST0xFIl0sImNsaWVudF9pZCI6ImVmYyIsImF1ZCI6Imh0dHBzOi8vcWEtZGhpLmNzNzcuZm9yY2UuY29tL2VmaW5hbmNpYWxjYXJlZXJzIiwic2NvcGUiOlsicmVjcnVpdGVyX3NlcnZpY2UiXSwiZXhwIjoxNzEzMzM5NjA1LCJqdGkiOiI4Y2M3MjIwYS1iNmQxLTQ2MzQtOWQ4Yi1hMDAzMDY0ODNmY2QifQ.pswOo6FWAor1CySsDpsBBPDwUg3FXLiSpd92PDIOdiOquF1AMgKiAsd262yRdnX8hkrekuYfcyf45V5LjSgu-Dl6T_EaqPsfJVRQ-rnJkuQyMQMZ1KNS-liLucKLZOM663dwaqxCP_kQ7DhM5RDpW0MDzGHuV-xjz_61xvmWaqRVCG6x0r1CqSXCdzVqdV4neudJuMaGM_MKi3PfHqKsENZ-nraQ5CQjyZ25eHLWss1p3GEhNxAm3IRsYbDZf_vFl66raGcwUizGjHkZc_npteF88TTmw4Vqzlyz8-T8St96IwsmbF5cf9bp6xnNzTrMDvB_3OOP0CzTepAGcz0-4Q
Handing API errors
As the eFinancialCareers‘ API is RESTful, any HTTP status codes within the 4xx and 5xx range are classified as errors. The XML representation in the response body will help you determine the cause of each individual error that occurred. The description of the error codes can be found here.
