LinkedIn API Client with OAuth 2 authorization written on PHP
Use composer package manager
composer require zoonman/linkedin-api-php-client
Or add this package as dependency to
If you have never used Composer, you should start here and install composer.
To start working with LinkedIn API, you will need to get application client id and secret.
Go to LinkedIn Developers portal and create new application in section My Apps.
Bootstrapping autoloader and instantiating a client
// ... please, add composer autoloader first include_once __DIR__ . DIRECTORY_SEPARATOR . 'vendor' . DIRECTORY_SEPARATOR . 'autoload.php'; // import client class use LinkedIn\Client; // instantiate the Linkedin client $client = new Client( 'LINKEDIN_APP_CLIENT_ID', 'LINKEDIN_APP_CLIENT_SECRET' );
Getting local redirect URL
To start linking process you have to setup redirect url.
You can set your own or use current one.
SDK provides you a
getRedirectUrl() helper for your convenience:
$redirectUrl = $client->getRedirectUrl();
We recommend you to have it stored during the linking session because you will need to use it when you will be getting access token.
Setting local redirect URL
Set a custom redirect url use:
Getting LinkedIn redirect URL
In order of performing OAUTH 2.0 flow, you should get LinkedIn login URL.
During this procedure you have to define scope of requested permissions.
Scope enum class to get scope names.
To get redirect url to LinkedIn, use the following approach:
// define scope $scopes = [ 'r_basicprofile', 'r_emailaddress', 'rw_company_admin', 'w_share', ]; $loginUrl = $client->getLoginUrl($scopes); // get url on LinkedIn to start linking
Now you can take user to LinkedIn. You can use link or rely on Location HTTP header.
Getting Access Token
To get access token use (don't forget to set redirect url)
$accessToken = $client->getAccessToken($_GET['code']);
Performing API calls
All API calls can be called through simple method:
$profile = $client->api( 'ENDPOINT', ['parameter name' => 'its value here'], 'HTTP method like GET for example' );
There are two helper methods:
// get method $client->get('ENDPOINT', ['param' => 'value']); //post $client->post('ENDPOINT', ['param' => 'value']);
To perform api call to get profile information
$profile = $client->get( 'people/~:(id,email-address,first-name,last-name)' ); print_r($profile);
To list companies where you are an admin
$profile = $client->get( 'companies', ['is-company-admin' => true] ); print_r($profile);
To share content on a personal profile
$share = $client->post( 'people/~/shares', [ 'comment' => 'Checkout this amazing PHP SDK for LinkedIn!', 'content' => [ 'title' => 'PHP Client for LinkedIn API', 'description' => 'OAuth 2 flow, composer Package', 'submitted-url' => 'https://github.com/zoonman/linkedin-api-php-client', 'submitted-image-url' => 'https://github.com/fluidicon.png', ], 'visibility' => [ 'code' => 'anyone' ] ] );
Please, open PR with your changes linked to an GitHub issue. You code must follow PSR standards and have PHPUnit tests.
If you have any issue with the project, feel free to report it on GitHub. Thank you!