Code Monkey home page Code Monkey logo

fb-kit's Introduction

Facebook Kit

Facebook Graph API JS Kit - A modern JS library for Graph API. Uses access token for working with API.

Requirements

  • Latest Browsers

Installation

In a browser:

<script src="https://unpkg.com/fb-kit/dist/fb-kit.min.js"></script>

Or You can install the package via npm or yarn:

NPM:

$ npm i -s fb-kit

Yarn:

$ yarn add fb-kit

Usage

import fbKit from 'fb-kit';

let opts = {
    version: 'v2.8',
    accessToken: 'User / Page / App Access Token',
    beta: false, // Optional - To make API calls to beta graph api.
    appId: '', // Optional - Used for generating login URL.
    debug: false // Debug mode for API requests.
};

const FB = new fbKit(opts);

// OR

const FB = fbKit.instance(opts);

Available Methods

getApiVersion()

Get Graph API version

Defaults: v2.8

let graphApiVersion = FB.getApiVersion();

setApiVersion(version)

Set default Graph API version to use for all requests.

let version = 'v2.2';

FB.setApiVersion(accessToken);

getAccessToken()

Get the access token (if previously set)

Defaults: null

let accessToken = FB.getAccessToken();

setAccessToken(accessToken)

Set an Access Token for all API calls.

let accessToken = '';

FB.setAccessToken(accessToken);

get(endpoint, params = {})

Make get requests.

FB.get('me')
  .then(response => {
    console.log(response)
  }).catch(error => {
    console.log(error)
  });

post(endpoint, params = {})

Make post requests.

let message = 'Hello World!';

FB.post('me/feed', { message: message })
  .then(response => {
    console.log(response)
  }).catch(error => {
    console.log(error)
  });

delete(endpoint)

Make delete requests.

let commentId = 12345678; // Comment ID to Delete

FB.delete(commentId)
  .then(response => {
    console.log(response)
  }).catch(error => {
    console.log(error)
  });

batch(batch = [])

Make batch requests.

let batch = [
    { method: 'get', relative_url: '4' },
    { method: 'get', relative_url: 'me/friends?limit=50' },
    { method: 'get', relative_url: '4', headers: { 'If-None-Match': '"7de572574f2a822b65ecd9eb8acef8f476e983e1"' } }, /* etags */
    { method: 'get', relative_url: 'me/friends?limit=1', name: 'one-friend' /* , omit_response_on_success: false */ },
    { method: 'get', relative_url: '{result=one-friend:$.data.0.id}/feed?limit=5'}
]

FB.batch(batch)
  .then(response => {
    console.log(response)
  }).catch(error => {
    console.log(error)
  });

getLoginUrl(opts = {})

Generate a login OAuth URL.

let loginUrl = FB.getLoginUrl({
    redirectUri: 'https://domain...',
    appId: '123456', // Optional - Default to the appId set in constructor.
    version: 'v2.8', // Optional - Default as per getApiVersion().
    scope: 'email', // Optional
    responseType: 'code' // Optional - Default: token
    display: 'pop', // Optional
    state: '123456789' // Optional
})

TODO

  • Add all kit methods.

Contributing

Please see CONTRIBUTING for details.

Credits

License

The MIT License (MIT). Please see License File for more information.

fb-kit's People

Contributors

irazasyed avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.