songkick/contacts

Ruby library for consuming Google, Yahoo!, Flickr and Windows Live contact APIs

Note¶ ↑

This is a fork of aeden/contacts to add:

• appdata parameter to Contacts::Yahoo.get_authentication_url

• context parameter to Contacts::WindowsLive.get_authentication_url

• Contacts::Flickr to use FlickrFu

Basic usage instructions¶ ↑

Fetch users’ contact lists from your web application without asking them to provide their passwords.

First, register your application’s domain. Then make users follow this URL:

Contacts::Google.authentication_url('http://mysite.com/invite')

They will authenticate on Google and it will send them back to the URL provided. Google will add a token GET parameter to the query part of the URL. Use that token in the next step:

gmail = Contacts::Google.new('[email protected]', params[:token])
contacts = gmail.contacts
#-> [ ['Fitzgerald', '[email protected]', '[email protected]'],
      ['William Paginate', '[email protected]'], ...
      ]

Author: Mislav Marohnić ([email protected])