This is a ruby gem for the Basecamp API. I've tried to make it as complete and true to the API as possible and everything generally follows the same layout as the API.
A quick note though, hopefully to save some people some frustration, if you see "all" in the method title, then it is not project specific. For example,
Basecampeverest::Project.all will return all the projects, and
Basecampeverest::TodoList.all will return ALL the Todo Lists for ALL projects. In the same methodology, any method that includes the word "find" is project specific where it applies.
- Installation
- Initializing the Connection
- Accesses
- Attachments
- Calendars
- Calendar Events
- Comments
- Documents
- Events
- Messages
- People
- Projects
- Todo Items
- Todo Lists
- Topics
- Uploads
- License
Simply go to your gemfile and add
gem 'basecampeverest'And then go to the terminal and run
bundle installand you should be all set!
Alternatively, you can run
gem install basecampeverestThe best way to perform the connection is with the ruby :before_filter command
Class whatever < ApplicationController
before_filter :basecamp_connect
...
...
...
private
def basecamp_connect
@authorization = { :username => "[email protected]", :password => "IuseSecureP@assw0rd$_" }
@user_agent = "PutAnythingHere ([email protected])"
@basecamp_ID = "123456"
Basecampeverest::Connect.new(@basecamp_ID, @authorization, @user_agent)
endInitializing the controller will return.
=> #<Basecampeverest::Connect:0x007abcd123455>This module checks for access to projects. Access API Reference.
There are four methods.
-
Access for Project
Basecampeverest::Access.for_project(project_id)
Returns a hash with the people that have access to the project.
-
Access for Calendar
Basecampeverest::Access.for_calendar(calendar_id)
Returns a hash with the people that have access to a calendar.
-
Grant Access to Project
The options hash is a hash with the user ID's and email addresses formatted like so:
{ "ids" => { 5, 6, 10 }, "email_addresses" => { "[email protected]", "[email protected]" } }
Pass in this hash to the method.
Basecampeverest::Access.grant_project(project_id, options={})
Returns a 204 if successful.
-
Revoke Access to user.
Pass in the user ID of the user to revoke access to the project. To obtain the user id take a look in the people section.
Basecampeverest::Access.revoke_project(project_id, options={})
Returns a 204 if successful.
This module is the first of a two step process for file uploads. Attachment API Reference
It has not been implemented yet.
This module controls the calendar. Calendar API Reference
There are five methods.
-
Find all Calendars
This method returns all calendars for a project.
Basecampeverest::Calendar.all
Returns an array of all the calendars
-
Find a specific Calendar
This method returns a specific calendar.
Basecampeverest::Calendar.find(calendar_id)
Returns information about a specific calendar
-
Create a Calendar
This method creates a calendar. The options hash should just contain a :name element.
Basecampeverest::Calendar.new(options={})
Returns a 201 with the information of the created calendar.
-
Update a Calendar
This method updates a calendar. The options hash should just contain the updated calendar information.
Basecampeverest::Calendar.new(options={})
Returns a 200 with the information of the updated calendar.
-
Delete a Calendar
This method deletes a calendar.
Basecampeverest::Calendar.delete(calendar_id)
Returns a message with the success or failure of the deletion.
This module controls the calendar events. A quick note, this is not to be confused with events, which is different. Yes they could have been better named, but they weren't. Calendar Events API Reference
There are eleven methods.
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
-
Upcoming events for the Project
This method
Basecampeverest::Returns a
Basecampeverest::Project.all
=>[{"id"=>494832908, "name"=>"Cool Basecamp Project", "description"=>"this is a description", "archived"=>false, "is_client_project"=>false,
"created_at"=>"2013-11-06T13:53:17.000-05:00", "updated_at"=>"2013-12-05T13:34:20.000-05:00", "draft"=>false,
"last_event_at"=>"2013-12-05T13:34:20.000-05:00", "starred"=>false,
"url"=>"https://basecamp.com/123456/api/v1/projects/494832908-Cool-Basecamp-Project.json"}]The MIT License (MIT)
Copyright (c) 2014 Veracross LLC, Alex Gordon
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.