= rest-graph 1.2.0 by Cardinal Blue ( http://cardinalblue.com ) == LINKS: * {github}[http://github.com/cardinalblue/rest-graph] * {rubygems}[http://rubygems.org/gems/rest-graph] * {rdoc}[http://rdoc.info/projects/cardinalblue/rest-graph] == DESCRIPTION: A super simple Facebook Open Graph API client == FEATURES: * Simple Graph API call * Simple FQL call * Utility to extract access_token and check sig in cookies == SYNOPSIS: # If you feel SYNOPSIS is so hard to understand, please read # {examples}[http://github.com/cardinalblue/rest-graph/tree/master/example]. require 'rest-graph' # Every option is optional. rg = RestGraph.new(:access_token => '...', :graph_server => 'https://graph.facebook.com/', :fql_server => 'https://api.facebook.com/', :accept => 'text/javascript', :lang => 'en-us', # this affect search :auto_decode => true, # decode by json :app_id => '123', :secret => '1829', # This handler callback is only called if auto_decode is set to true, # otherwise, it's ignored. :error_handler => lambda{ |hash| raise ::RestGraph::Error.new(hash) }, # You may want to do this in Rails to do debug logging: :log_handler => lambda{ |duration, url| Rails.logger.debug("RestGraph " \ "spent #{duration} " \ "requesting #{url}") }) # You may want to do redirect instead of raising exception, for example, # in a Rails application, you might have this private controller method: def redirect_to_authorize error = nil redirect_to @rg.authorize_url(:redirect_uri => request.url) end # and you'll use that private method to do error handling: def setup_rest_graph @rg = RestGraph.new(:error_handler => method(:redirect_to_authorize)) end # This way, you don't have to check if the token is expired or not. # If the token is expired, it will automatically do authorization again. # Other simple API call: rg.get('me') # GET https://graph.facebook.com/me?access_token=... rg.get('4/likes') # GET https://graph.facebook.com/4/likes?access_token=... # GET https://graph.facebook.com/search?q=taiwan&access_token=... rg.get('search', :q => 'taiwan') # GET https://graph.facebook.com/me?metadata=1&access_token=... rg.get('me', :metadata => '1') # POST https://graph.facebook.com/me/feed?message=bread%21&access_token=... rg.post('me/feed', :message => 'bread!') # for fully blown cookies hash rg = RestGraph.new(:app_id => '123', :secret => '1829') rg.parse_cookies!(cookies) # auto save access_token if sig checked rg.data['uid'] # => facebook uid # FQL query, same as: # GET https://api.facebook.com/method/fql.query?query= # SELECT+name+FROM+page+WHERE+page_id%3D%22123%22& # format=json&access_token=... rg.fql('SELECT name FROM page WHERE page_id="123"') # FQL multiquery, same as: # GET https://api.facebook.com/method/fql.multiquery?query= # %7BSELECT+name+FROM+page+WHERE+page_id%3D%22123%22&%2C # SELECT+name+FROM+page+WHERE+page_id%3D%22456%22&%7D # format=json&access_token=... rg.fql_multi(:q1 => 'SELECT name FROM page WHERE page_id="123"', :q2 => 'SELECT name FROM page WHERE page_id="456"') # default setting: class RestGraph def self.default_app_id '456' end def self.default_secret 'category theory' end end # auto load config require 'rest-graph' require 'rest-graph/auto_load' # under Rails, load config/rest-graph.yaml RestGraph.new # all default options would honor config RestGraph.new(:app_id => '123') # default could be override as well # manually load config require 'rest-graph/load_config' RestGraph::LoadConfig.load_config!('path/to/rest-graph.yaml', 'env') # see test/config/rest-graph.yaml for an example for config # oauth utilites: # https://graph.facebook.com/oauth/authorize?client_id=...& RestGraph.new.authorize_url(:redirect_uri => '...') # get access token by: # https://graph.facebook.com/oauth/access_token?code=...& rg = RestGraph.new rg.authorize!(:redirect_uri => '...', :code => 'zzz') rg.access_token # your access_token is now available rg.data['expires'] # other values as well == REQUIREMENTS: * Tested with MRI 1.8.7 and 1.9.1 * gem install rest-client * gem install json (optional) * gem install json_pure (optional) * gem install rack (optional, to parse access_token in HTTP_COOKIE) == INSTALL: > gem install rest-graph # or if you want rails plugin and bleeding edge > script/plugin install git://github.com/cardinalblue/rest-graph.git == LICENSE: Apache License 2.0 Copyright (c) 2010, Cardinal Blue Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.