linkedin Ruby Gem

To use the LinkedIn API, you must first authenticate using OAuth2. This involves initializing a LinkedIn::Client with your consumer key and secret, generating an authorization URL, and then exchanging the authorization code (received via a callback) for access tokens.

1. Initialize Client: LinkedIn::Client.new(consumer_key, consumer_secret)
2. Generate URL: Use client.authorize_url with your redirect_uri and desired scope (e.g., r_basicprofile+r_emailaddress).
3. Exchange Code: After the user authorizes, LinkedIn redirects to your callback with a code parameter. Use client.authorize_from_request(params[:code], :redirect_uri => '...') to obtain the access token.
4. Persistent Session: You can later re-authorize using a previously saved access token with client.authorize_from_access("ACCESS_TOKEN").

require 'rubygems'
require 'linkedin'

# 1. Initialize
client = LinkedIn::Client.new('your_consumer_key', 'your_consumer_secret')

# 2. Get Authorization URL
url = client.authorize_url(:redirect_uri => 'https://www.yourdomain.com/callback', :state => SecureRandom.uuid, :scope => "r_basicprofile+r_emailaddress")

# 3. Exchange code from callback for access token
# params[:code] is provided by the LinkedIn redirect
access_token = client.authorize_from_request(params[:code], :redirect_uri => 'https://www.yourdomain.com/callback')

# 4. Or use a saved token later
client.authorize_from_access("OU812")

This pattern demonstrates how to manage LinkedIn OAuth2 sessions in a Sinatra application using session to store access tokens and a helper to initialize the LinkedIn::Client with the stored token.

require "rubygems"
require "haml"
require "sinatra"
require "linkedin"

enable :sessions

helpers do
  def login?
    !session[:atoken].nil?
  end

  def profile
    linkedin_client.profile unless session[:atoken].nil?
  end

  private
  def linkedin_client
    client = LinkedIn::Client.new(settings.api, settings.secret)
    client.authorize_from_access(session[:atoken])
    client
  end
end

configure do
  set :api, "your_api_key"
  set :secret, "your_secret"
end

get "/auth" do
  client = LinkedIn::Client.new(settings.api, settings.secret)
  request_token = client.request_token(:oauth_callback => "http://#{request.host}:#{request.port}/auth/callback")
  session[:rtoken] = request_token.token
  session[:rsecret] = request_token.secret
  redirect client.request_token.authorize_url
end

get "/auth/callback" do
  client = LinkedIn::Client.new(settings.api, settings.secret)
  if session[:atoken].nil?
    pin = params[:oauth_verifier]
    atoken, asecret = client.authorize_from_request(session[:rtoken], session[:rsecret], pin)
    session[:atoken] = atoken
    session[:asecret] = asecret
  end
  redirect "/"
end

Use the profile method on a LinkedIn::Client instance to retrieve profile information. You can fetch the authenticated user's profile, a specific user by ID or URL, or filter specific fields.

• Authenticated User: client.profile
• By ID: client.profile(:id => 'ID')
• By URL: client.profile(:url => 'URL')
• Specific Fields: Use the :fields option to request specific data (e.g., positions).
• Email Search: Use the :email option for multi-email searches.

# Get current user profile
client.profile

# Get profile by ID
client.profile(:id => 'gNma67_AdI')

# Get profile by URL
client.profile(:url => 'http://www.linkedin.com/in/netherland')

# Get profile with specific fields (e.g., positions)
user = client.profile(:fields => %w(positions))
companies = user.positions.all.map{|t| t.company}

# Multi-email search
account_exists = client.profile(:email => 'email=yy@zz.com,email=xx@yy.com', :fields => ['id'])