WishSimple

Ruby wrapper for the WishSimple API

WishSimple provides gift recommendations as a service. It's currently in private beta and you can request an API key here.

Installation

gem install wishsimple

Authentication

If you're using Rails, you may want to add the following to config/initializers/wishsimple.rb:

WishSimple.configure do |config|
  config.api_key = '<your API key>'
end

You can also set the key directly:

WishSimple.api_key = '<your API key>'

Usage

WishSimple uses a Facebook user's interactions with products to generate gift recommendations. Currently, only purchases are supported, though more types of interactions will be supported in the near future (e.g. ratings, adding to a wish list, etc.).

To begin, you'll need the following data:

facebook_uid - The Facebook user's numerical UID
access_token - The Facebook user's OAuth access token (see "Permissions" below)
product_uid - Whatever you use to identify the product; usually the database ID

Recording a purchase is as easy as:

user = WishSimple::User.create(facebook_uid, access_token)
product = WishSimple::Product.create(product_uid)
user.purchase!(product)

You can interact with objects as you would expect:

user = WishSimple::User.new(facebook_uid)
user.access_token = access_token
user.save

purchase = WishSimple::Purchase.new
purchase.user = user
purchase.product = product
purchase.save

You can delete data like so:

# Purchases
purchase = WishSimple::Purchase.new(user: user, product: product)
purchase.destroy

# Users (this will also delete the user's purchases)
user = WishSimple::User.new(facebook_uid)
user.destroy

# Products (this will also delete the product's purchases)
product = WishSimple::Product.new(product_uid)
product.destroy

Permissions

You'll want to request the following Facebook permissions when generating the access token:

user_birthday, user_interests, user_likes

Gift Recommendations

Here's a funny riddle:

Q: What kind of gift recommendation service doesn't actually have the ability to request the gift recommendations?
A: One that's in private beta.