Ruby wrapper for the LinkedIn API. Heavily inspired by John Nunemaker's Twitter gem, the LinkedIn gem provides an easy-to-use wrapper for LinkedIn's Oauth/XML APIs.
sudo gem install gemcutter gem tumble sudo gem install linkedin
LinkedIn's API uses Oauth for authentication. Luckily, the LinkedIn gem hides most of the gory details from you.
require 'rubygems' require 'linkedin' # get your api keys at https://www.linkedin.com/secure/developer client = LinkedIn::Client.new('your_consumer_key', 'your_consumer_secret') rtoken = client.request_token.token rsecret = client.request_token.secret # to test from your desktop, open the following url in your browser # and record the pin it gives you client.request_token.authorize_url => "https://api.linkedin.com/uas/oauth/authorize?oauth_token=<generated_token>" # then fetch your access keys client.authorize_from_request(rtoken, rsecret, pin) => ["OU812", "8675309"] # <= save these for future requests # or authorize from previously fetched access keys c.authorize_from_access("OU812", "8675309") # you're now free to move about the cabin, call any API method
# get the profile for the authenticated user client.profile # get a profile for someone found in network via ID client.profile(:id => 'gNma67_AdI') # get a profile for someone via their public profile url client.profile(:url => 'http://www.linkedin.com/in/netherland')
More examples in the examples folder.
For a nice example on using this in a Rails App.
- Implement Messaging APIs
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright (c) 2009 Wynn Netherland. See LICENSE for details.