A Ruby wrapper for the Behance API.
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
lib
spec
.gitignore
CHANGELOG.md
Gemfile
LICENSE.txt changing license holder Sep 19, 2012
README.md
Rakefile
behance.gemspec

README.md

The Behance Ruby Gem

A Ruby wrapper for the Behance API.

More information about the API capabilities can be found here.

Installation

$ gem install behance

API Usage Examples

First of all, you will need to get an access token here.

Once you get it, you'll be able to start playing

# initializing the client
client = Behance::Client.new(access_token: "access-token")

Projects

Search for projects

client.projects
client.projects(city: "San Francisco", state: "California", field: "branding")

Get the information and content of a project

client.project(5133725)

Get the comments for a project

client.project_comments(5133725)

Users

Search for users

client.users
client.users(state: "California", city: "San Francisco")

Get basic information about a user

client.user(920309)
client.user("jonkap1")

Get the projects published by a user

client.user_projects(920309)
client.user_projects("jonkap1")
client.user_projects("jonkap1", page: 2, sort: "views")

Get the works-in-progress published by a user

client.user_wips(920309)
client.user_wips(920309, page: 2)
client.user_wips("jonkap1", sort: "comments", page: 3)

Get a list of user's recently appreciated projects

client.user_appreciations(920309)
client.user_appreciations("jonkap1", page: 2)

Get a list of a user's collections

client.user_collections(42)
client.user_collections(42, page: 2)
client.user_collections("rur", page: 2)

Get user's statistics (all-time and today)

client.user_stats(42)
client.user_stats("jonkap1")

Get a list of creatives who follow the user

client.user_followers(1)
client.user_followers("foo", sort: "alpha", page: 2)

Get a list of creatives followed by the user

client.user_following(1)
client.user_following("foo", sort: "alpha", page: 2)

A list of the user's professional experience

client.user_work_experience(42)
client.user_work_experience("jonkap1")

Works in Progress

Search for works-in-progress

client.wips
client.wips(time: "today", page: 2)

Get information about a work in progress

client.wip(69)

Get information and contents of a revision of a work in progress

client.wip_revision(69, 133)

Get comments on a revision of a work in progress

client.wip_revision_comments(69, 133)
client.wip_revision_comments(69, 133, page: 2)

Collections

Search for collections

client.collections
client.collections(time: "today", page: 2)

Get basic information about a collection

client.collection(5074147)

Get projects from a collection

client.collection_projects(5074147)
client.collection_projects(5074147, page: 2)

Creative Fields

Retrieves all Creative Fields

client.fields

Retrieves popular Creative Fields

client.popular

Creatives To Follow

Provides a list of creatives you might be interested in following

client.creatives_to_follow
client.creatives_to_follow(page: 2)

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

Copyright

Copyright (c) 2012-2013 Tractical. See LICENSE for details.