...
- Login with external profile
- Link with external profile
Login with external profile
Prerequisites
The following prerequisites need to be met, if authentication via external profiles should be supported through the eRecruiter API.
...
The configuration information is part PortalSettings object in the API mandator response (http://api.erecruiter.net/Help/Api/GET-Api-Mandator)
Login with external profile
You have the possibility to let applicants login to your applicant portal via an external profile. The authentication with the external profile platform must be handled by yourself. We offer an open source library for connecting to XING and LinkedIn for the .NET platform, which we use in our applicant portal (https://github.com/eRecruiter/eRecruiter.SocialConnector).
...
- Authorize with third party to retrieve the external profile identifier.
Use the following request to with the retrieved external profile identifier for either XING or LinkedIn
Code Block title Get an applicant by their third party identifier GET Api/Applicant?identifier={identifier}&thirdParty={thirdParty}The request checks if the applicant profile already exists in the eRecruiter and returns the profile if found.
- If the profile was found you can successfully authenticate the applicant in your applicant portal.
Link with external profiles
Two parameters are mandatory for linking the external profiles to your applicant profile:
...
After the applicant has been authenticated with the external platform the basic data of the external profile has to be fetched.
Use the resource https://api.xing.com/v1/users/me to retrieve the basic user profile (see XING User Profile).
...
| Code Block | ||
|---|---|---|
| ||
POST Api/Applicant/Xing/{applicantId}?identifier={identifier}&profileUrl={profileUrl} |
The resource https://api.linkedin.com/v1/people/~:(id,first-name,last-name,public-profile-url)?format=json can be used to retrieve the basic user profile (see Sign-In with LinkedIn)
...
| Code Block | ||
|---|---|---|
| ||
DELETE Api/Applicant/Xing/{applicantId}
DELETE Api/Applicant/LinkedIn/{applicantId} |
Fill applicant's profile with data from the external profile
This is a recommendation on how to fill the applicant's profile with the data from the external profile. Our applicant portal maps the third party information to the eRecruiter entities as seen in the table below. As some entities in the eRecruiter require some properties, we describe how we managed the mapping from the third party profile to the applicant's profile.
...