Get access to your LinkedIn account and search for people and companies with the LinkedIn plug-in

Posted: April 23rd, 2013 | Author: | Filed under: API, Plugin | Comments Off

linkedin_logo

Our new LinkedIn Plug-in allows you to get access to your LinkedIn account, read your profile data, read data from your connection profile, get a list of connections, search people and companies, and read data from a company profile.

To add this plug-in to an app, you will just need to follow these steps in Appery.io:

  1. From the Appery.io builder, select Create New and then From Plug-in.
  2. Click the check box for LinkedIn oAuth API and then click on the Import selected plugins button.
  3. Open the Services/LINKEDIN_Settings file and set your API key and Secret Key. If you don’t have them, register on  http://developer.linkedin.com/ and get the keys for your services.

Once you’ve created a new app based on this plug-in, you actually have a simple demo app with login page and services that can be used for creating other pages you want to have. In this tutorial, we’ll first walk through the sample app which can be built using the services included with the plug-in. Then, we’ll show you what’s “under the hood”.

The App

You can build the app that will allow you to do the following:

  1. On the start page log in with your LinkedIn credentials:
    IMG_0141
  2. Look at your profile:
    IMG_0142
  3. Search connections:
    IMG_0143
  4. Search companies:
    IMG_0144
  5. Look at a company or connection profile:
    IMG_0145 IMG_0146

You can build pages looking like shown here or create another design of pages using the services described below.

Under the Hood

Now let’s take that peek under the hood.

Services

Services from the plug-in are linked to UI components as part of the design of the app. The following REST services that are defined in the LinkedIn plug-in are used in the app.

LINKEDIN_getProfile

To read data from your profile you, should use the LINKEDIN_getProfile service. The REST Service Properties tab displays the URL, main settings, and whether a proxy is used:

li01

The Request Parameters tab contains  the parameters sent to the LinkedIn service:

li02

(You can find the list at http://developer.linkedin.com/documents/profile-fields.)

The service can be tested and then the returned data (from a successful test) can be used to automatically create a response parameter structure for the service:

li03

The other services are set in the same way with their own parameters.

LINKEDIN_getSelectedConnection

To read data from connection profile you should use the LINKEDIN_getSelectedConnection service. The various service properties are shown below:

li04

Request Parameters:

li05

Response Parameters:

li06

 

LINKEDIN_getConnections

To get list of your connections use the LINKEDIN_getConnections service. The various service properties are shown below:

li07

Request Parameters:

li08

Response Parameters:

li09

LINKEDIN_searchPeople

You can search for people on the LinkedIn network using the LINKEDIN_searchPeople service. The various service properties are shown below:

li10

Request Parameters:

li11

Response Parameters:

li12

LINKEDIN_companySearch

You can search for companies on the LinkedIn network using the LINKEDIN_companySearch service. The various service properties are shown below:

li13

Request Parameters:

li14

Response Parameters:

li15

LINKEDIN_getCompany

To read data from the profile of a company you should use the LINKEDIN_getCompany service. The various service properties are shown below:

li16

Request Parameters:

li17

Response Parameters:

li18

JavaScript

The linkedin_api JavaScript code that comes with the plug-in is used for authorization process.

li19

To find out about the LinkedIn API, go to http://developer.linkedin.com/.