https://github.com/vanng822/facebook-nodejs
Nodejs module for Facebook api
https://github.com/vanng822/facebook-nodejs
facebook-api facebook-nodejs fql graph graph-api nodejs
Last synced: 5 months ago
JSON representation
Nodejs module for Facebook api
- Host: GitHub
- URL: https://github.com/vanng822/facebook-nodejs
- Owner: vanng822
- License: mit
- Created: 2012-07-25T21:32:46.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2018-05-05T10:17:48.000Z (almost 7 years ago)
- Last Synced: 2024-11-14T09:56:00.329Z (5 months ago)
- Topics: facebook-api, facebook-nodejs, fql, graph, graph-api, nodejs
- Language: JavaScript
- Homepage:
- Size: 83 KB
- Stars: 28
- Watchers: 5
- Forks: 14
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Facebook nodejs
A simple module for querying Facebook graph api and fql
## Usage example
// run first: npm install express fbgraphapi body-parser cookie-parser express-session
const express = require('express');
const fbgraph = require('fbgraphapi');
const bodyParser = require('body-parser');
const cookieParser = require('cookie-parser');
const session = require('express-session');
const app = express();
// parse application/x-www-form-urlencoded
app.use(bodyParser.urlencoded({ extended: false }));
app.use(cookieParser())
app.use(session({
secret: 'keyboard cat',
resave: false,
saveUninitialized: true,
cookie: { secure: false }
}))
app.use(fbgraph.auth( {
appId : "...",
appSecret : "...",
redirectUri : "http://0.0.0.0:3000/",
apiVersion: "v2.9",
skipUrlPatterns: ["/favicon.ico"]
}));
app.get('/login', function(req, res) {
console.log('Start login');
fbgraph.redirectLoginForm(req, res);
});
app.get('/', function(req, res) {
if (!req.hasOwnProperty('facebook')) {
console.log('You are not logged in');
return res.redirect('/login');
}
/* See http://developers.facebook.com/docs/reference/api/ for more */
req.facebook.graph('/me', function(err, me) {
console.log(me);
});
req.facebook.graph('/me?fields=id,name', function(err, me) {
console.log(me);
});
req.facebook.me(function(err, me) {
console.log(me);
});
// /me/likes
req.facebook.my.likes(function(err, likes) {
console.log(likes);
});
res.end("Check console output");
});
app.listen(3000);
Or if have a valid access token for instance from javascript fb connect
var fb = new fbgraph.Facebook(accessToken, 'v2.2');
fb.me(function(err, me) {
console.log(me);
});
Or do stuff on behalf of the app or user with granted permissions
var fb = new fbgraph.Facebook(fbgraph.getAppId() + '|' + fbgraph.getAppSecret());
fb.post('/{user-id}/feed', {message: 'Hello world'},function(err, res) {
console.log(err, res);
});
## Facebook API reference
Visit the links bellow for API documentation of Facebook API
https://developers.facebook.com/docs/graph-api/using-graph-api
## Methods
### auth(config)
config is an object with those properties
* `appId` Facebook application Id
* `appSecret` Secret hash key generated by Facebook
* `redirectUri` The url to redirect to when user logged in.
* `apiVersion` Which api version to use, example v2.2
* `scope` Permissions/scope that your application asks for, optional and default empty.
* `skipUrlPatterns` Array of patterns which to not apply authentication on. They can be regexp or string. If string a regexp will be created with wildcard appending at the end. If you want an exact url make sure specify regexp.
### authenticate(req, res, next)
This method is returned when calling auth() above. When loggin is successfull it will assign a Facebook instance to req (see example above).
### redirectLoginForm(req, res)
This method will redirect user to Facebook login form.
### destroySession(req, res, clearCookie)
This method is for logging out user or for any reason want to clear user's logged-in info
### getAppId()
return app id, set via auth()
### getAppSecret()
return app secret, set via auth()
## Classes
### Facebook(accessToken, apiVersion)
* `accessToken` Valid access token from Facebook (oauth_token).
* `apiVersion` Which api version to use
* `.graph(path, callback)` Main method for making call to Facebook API. Path can contain only /me/likes or with params like /me/likes?limit=3
* `.post(path, params, callback) or post(path, callback)` Publishing to Facebook, see https://developers.facebook.com/docs/graph-api/using-graph-api/v2.0#publishing for detail. Path can contain post data such as /123/feed?message=hello
* `.update(path, params, callback) or update(path, callback)` Updating a post on Facebook, see https://developers.facebook.com/docs/graph-api/using-graph-api/v2.0#updating for defail. Path can contain post data such as /123_123456789?message=edited
* `.delete(path, callback)` Deleting a post on Facebook, see https://developers.facebook.com/docs/graph-api/using-graph-api/v2.0#deleting for defail
* `.fql(query, callback)` Specific method for making fql query to Facebook API
* `.search(params, callback)` params is an object which properties are any param based on this https://developers.facebook.com/docs/graph-api/using-graph-api#search
* `.me(callback, fields)` Specific method to get info of the logged user, same as /me when using graph-method. Fields is comma-separated for instance fields=id,name
* `.my` Instance of My class
Usage: if have a valid accessToken for instance from js login
var fb = new Facebook(accessToken, 'v2.2');
fb.me(function(err, me) {
console.log(me);
});
### My(facebook)
This class uses internally to create object my (property in Facebook). This object wrap the me-object. Each connection type is a method. This means that you can make a call like
req.facebook.my.friends(function(err, friends) {
console.log(friends)
});
// OR for checkins
req.facebook.my.checkins(function(err, checkins) {
console.log(checkins)
});
Supported connection types are:
* `friends`
* `feed`
* `likes`
* `movies`
* `music`
* `books`
* `albums`
* `notes`
* `permissions`
* `photos`
* `videos`
* `events`
* `groups`
* `checkins`
* `locations`
If you can not find a connection that Facebook has but not here you can use connection-method
req.facebook.my.connection('{connection type}', function(err, result) {
console.log(result)
});