Introduction to LinkedIn API
- LinkedIn API allows developers to interact with LinkedIn's platform programmatically.
- It's crucial to understand OAuth authentication, the protocol LinkedIn uses to authorize API requests.
- Ensure you've created an app in the LinkedIn Developer Portal to obtain the necessary API keys and access tokens.
Authentication – Using OAuth 2.0
- LinkedIn API requires OAuth 2.0 for authenticating API calls. Familiarize yourself with OAuth's authorization code flow.
- Initiate authorization by redirecting the user to LinkedIn's authorization page using your app's client ID.
- Once authorized, LinkedIn redirects back to your specified redirect URI, including an authorization code.
- Exchange this authorization code for an access token using a POST request to LinkedIn's token endpoint.
PHP Code Example for OAuth 2.0
$client_id = 'your_client_id';
$client_secret = 'your_client_secret';
$redirect_uri = 'your_redirect_uri';
$authorization_code = 'authorization_code';
$url = 'https://www.linkedin.com/oauth/v2/accessToken';
$params = [
'grant_type' => 'authorization_code',
'code' => $authorization_code,
'redirect_uri' => $redirect_uri,
'client_id' => $client_id,
'client_secret' => $client_secret,
];
$options = [
'http' => [
'header' => "Content-type: application/x-www-form-urlencoded\r\n",
'method' => 'POST',
'content' => http_build_query($params),
],
];
$context = stream_context_create($options);
$response = file_get_contents($url, false, $context);
$data = json_decode($response);
$access_token = $data->access_token;
Making an API Call to Fetch Profile Data
- Use the access token to authenticate subsequent API requests.
- To fetch profile data, make a GET request to LinkedIn's `me` endpoint, adding the token to the Authorization header.
PHP Code Example to Fetch Profile Data
$access_token = 'your_access_token';
$options = [
'http' => [
'header' => "Authorization: Bearer $access_token\r\n",
'method' => 'GET',
],
];
$context = stream_context_create($options);
$url = 'https://api.linkedin.com/v2/me';
$response = file_get_contents($url, false, $context);
$user_info = json_decode($response, true);
// Display user information
echo 'Hello, ' . $user_info['localizedFirstName'] . ' ' . $user_info['localizedLastName'];
Error Handling and Best Practices
- Always check for error responses from LinkedIn's API. Handle exceptions gracefully within your application.
- Respect LinkedIn's API rate limits to avoid having your app blocked.
- Securely store your client secret and access tokens, avoiding exposure in client-side code.
