pipejump gem is a Ruby-based client for the API of the Base CRM ( www.futuresimple.com/base )
There are no dependencies required to use this code.
The gem available via Rubygems. To install it, use the following command:
sudo gem install pipejump
To get the latest version, clone the gem from github and run rake install:
git clone http://github.com/pipejump/pipejump cd pipejump rake install
Before using this gem you must require it by calling:
require 'pipejump'
To use the client, you must first authenticate the client with the API by initializing an instance of the Pipejump::Session class. You will later use this instance for communication with the API.
@session = Pipejump::Session.new(:email => 'you@email.com', :password => 'your_password')
If the credentials are incorrect, this will raise a Pipejump::AuthenticationFailed error.
If authentication succeeds, this will return a new Pipejump::Session instance which you can use to communicate with the API.
As of version 0.1.1 you can use the token which is fetched when authenticating using the email and password. So once you get the token, you can use it for future initialization of the Session and not send the username and password, which is a more secure.
@session = Pipejump::Session.new(:token => 'your_token')
Also, as of version 0.1.1 connection is performed over SSL.
For more information on the Session, consult the wiki page at github.com/pipejump/pipejump/wiki/Session
To access any resources, you need a valid Session instance, referred to as @session in the following examples.
You can access your account by calling
@session.account
For more information, consult the wiki page at github.com/pipejump/pipejump/wiki/Account
You can access your deals by calling
@session.deals
With Deals you get access to Notes, Reminders and Deal Contacts.
For more information, consult the wiki page at github.com/pipejump/pipejump/wiki/Deals
You can access your contacts by calling
@session.contacts
For more information, consult the wiki page at github.com/pipejump/pipejump/wiki/Contacts
You can access your sources by calling
@session.sources
For more information, consult the wiki page at github.com/pipejump/pipejump/wiki/Sources
You’re more than welcome to fork and improve this gem. Usual rules:
-
Fork the project.
-
Make your feature addition or bug fix.
-
Add tests for it. This is important so I don’t break it in a future version unintentionally.
-
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-
Send me a pull request.
Copyright © 2010-2012 Future Simple. See LICENSE for details.