fellowshipone

node-fellowshipone

A Fellowship One API wrapper for Node.js

In very early stages.

Allows you to:

• use a username/password to easily get OAuth tokens for dealing with Fellowship One (i.e. 2nd-party credentials-based authentication)
• other functionality coming later...

See passport-fellowshipone for 3rd-party OAuth authentication.

Install

$ npm install fellowshipone

Usage

Getting a token

var f1 = new F1({
  apiURL: 'http://mychurch.staging.fellowshiponeapi.com/v1',
  username: 'joe',
  password: 'joespassword',
  oauth_credentials: {
    consumer_key: '123',
    consumer_secret: '456789'
  }
})
f1.get_token(function(err, oauth_credentials, userURL) {
  request.get(userURL, { oauth: oauth_credentials, json: true }, function(err, res, body) {
    console.log('hi there, %s %s', body.firstName, body.lastName)
  })
})

Getting a token - alternate method

var config = {
  apiURL: 'http://mychurch.staging.fellowshiponeapi.com/v1',
  username: 'joe',
  password: 'joespassword',
  oauth_credentials: {
    consumer_key: '123',
    consumer_secret: '456789'
  }
}
var f1 = new F1(config)
// this method is useful for integrating with other APIs
f1.authenticate(function(err) {
  console.log('got tokens: %s/%s', config.oauth_credentials.token,
    config.oauth_credentials.token_secret)
  console.log('user URL is %s', config.userURL)
})

Tests

$ npm install --dev
$ make test

License

The MIT License

Copyright (c) 2014-2015 Dave Henderson

Changelog

0.2.9 (2015-03-17)

Full Changelog