fitbit-omni-api 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 3bb58a076555dbaeef38610a7e7cc2035542d1f5
+  data.tar.gz: 1295e14ef5ce64bb429779109eac458c318f524d
+SHA512:
+  metadata.gz: 0dbc41a2b02902432761fd992bda76de1cb5885cdf4d231bb851c235ee57d7be5a12ad21c4c33504fc79c7ba390f8ff8808643499b523549988550d945b07127
+  data.tar.gz: 8fc3c5c81be51e371f440f75c3fd033412c9dcf2dce1da073704123313c75946d804bbde0fe2df524061c01fe7b83029db331782a819b2079479355b2c8bec6a

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2012 TK Gospodinov, (c) Scott McGrath
+
+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.

data/README.md

@@ -0,0 +1,93 @@
+# Fitbit OmniAuth Strategy
+
+This gem is an OmniAuth 1.0+ Strategy for the [Fitbit API](https://wiki.fitbit.com/display/API/OAuth+Authentication+in+the+Fitbit+API).
+
+## Usage
+
+Add the strategy to your `Gemfile`:
+
+```ruby
+gem 'fitbit-omni-api'
+```
+
+Then integrate the strategy into your middleware:
+
+```ruby
+use OmniAuth::Builder do
+  provider :fitbit, 'consumer_key', 'consumer_secret'
+end
+```
+
+In Rails, create a new file under config/initializers called omniauth.rb to plug the strategy into your middleware stack.
+
+```ruby
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider :fitbit, 'consumer_key', 'consumer_secret'
+end
+```
+
+To register your application with Fitbit and obtain a consumer key and secret, go to the [Fitbit application registration](https://dev.fitbit.com/apps/new).
+
+For additional information about OmniAuth, visit [OmniAuth wiki](https://github.com/intridea/omniauth/wiki).
+
+For a short tutorial on how to use OmniAuth in your Rails application, visit [this tutsplus.com tutorial](http://net.tutsplus.com/tutorials/ruby/how-to-use-omniauth-to-authenticate-your-users/).
+
+## Accessing the Fitbit API
+
+An API call can be instantiated with `Fitbit::Api.new({}).api_call()`  
+Each call requires:
+* Fitbit consumer_key and consumer_secret
+* A params Hash containing the Fitbit API method, plus all required parameters 
+* Optionally, for authenticated API calls, your user's Fitbit auth token and auth secret
+
+An example of an authenticated API call: 
+
+```ruby
+Fitbit::Api.new({}).api_call(
+  'consumer_key',
+  'consumer_secret',
+  params,
+  'auth_token',
+  'auth_secret'
+)
+```
+
+OmniAuth Fitbit supports the Fitbit Resource Access API and the Fitbit Subscriptions API.
+
+To access the Resource Access API, consult the API docs and provide the required parameters. For example,
+the API-Search-Foods method requires 'api-version', 'query' and 'response-format'. There's also an optional
+Request Header parameter, 'Accept-Locale'. A call to API-Search-Foods might look like this:
+
+```ruby
+def fitbit_foods_search
+  params = {
+    'api-method'      => 'api-search-foods',
+    'query'           => 'buffalo chicken',
+    'response-format' => 'json',
+    'Accept-Locale'   => 'en_US',
+  }
+  request = Fitbit::Api.new({}).api_call(
+    'consumer_key',
+    'consumer_secret',
+    params,
+    'auth_token',
+    'auth_secret'
+  )
+  @response = request.body
+end
+```
+
+A few notes: 'api-version' defaults to '1' and can be omitted from Fitbit-Omni-Api calls.
+If you omit the 'response-format', the response will be in the default xml format.
+Some authenticated API methods can be accessed without auth tokens, if you supply a user's
+user-id (see the API docs for details).
+
+To access the Subscription API, two new api methods were created just for this gem:
+API-Create-Subscription and API-Delete-Subscription. These api methods only exist in this gem,
+not the Fitbit API. If you consult the Subscription API docs for adding and deleting subscriptions,
+and supply the required parameters, these two api methods work just as described for the
+Resource Access API. NOTE: To subscribe to ALL of a user's changes, make 'collection-path' = 'all'.
+
+## Copyright
+
+Copyright (c) 2012 TK Gospodinov, (c) Scott McGrath 2013. See [LICENSE](https://github.com/tkgospodinov/omniauth-fitbit/blob/master/LICENSE.md) for details.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/api/fitbit_api.rb

@@ -0,0 +1,767 @@
+module Fitbit
+  class Api < OmniAuth::Strategies::Fitbit
+    
+    def api_call consumer_key, consumer_secret, params, auth_token="", auth_secret=""
+      api_params = get_lowercase_api_method(params)
+      api_method = api_params['api-method']
+      fitbit = @@fitbit_methods[api_method]
+      api_error = get_api_errors(api_params.keys, fitbit, auth_token, auth_secret)
+      raise "#{api_method} " + api_error if api_error
+      access_token = build_request(consumer_key, consumer_secret, auth_token, auth_secret)
+      send_api_request(api_params, fitbit, access_token)
+    end
+
+    def get_fitbit_methods
+      @@fitbit_methods
+    end
+
+    private 
+
+    def get_lowercase_api_method params
+      params['api-method'] ||= nil
+      params['api-method'].downcase!
+      params
+    end
+
+    def get_api_errors params_keys, fitbit, auth_token="", auth_secret="" 
+      if fitbit
+        no_auth_tokens = true if (auth_token == "" or auth_secret == "")
+        get_error_message(params_keys, fitbit, no_auth_tokens)
+      else
+        "is not a valid Fitbit API method." 
+      end
+    end
+
+    def get_error_message params_keys, fitbit, no_auth_tokens
+      if missing_url_parameters? fitbit['url_parameters'], params_keys
+        url_parameters_error(fitbit['url_parameters'], params_keys)
+      elsif fitbit['post_parameters'] and missing_post_parameters? fitbit['post_parameters'], params_keys
+        post_parameters_error(fitbit['post_parameters'], params_keys)
+      elsif fitbit['auth_required'] and no_auth_tokens
+        auth_error(fitbit['auth_required'], params_keys.include?('user-id'))
+      end
+    end
+
+    def missing_url_parameters? required, supplied
+      url_parameters = get_url_parameters(required, supplied)
+      required and supplied & url_parameters != url_parameters
+    end
+
+    def get_url_parameters required, supplied
+      if required.is_a? Hash
+        get_dynamic_url_parameters(required, supplied)
+      else
+        required
+      end
+    end
+
+    def get_dynamic_url_parameters required, supplied
+      required.keys.each do |x| 
+        return required[x] if supplied.include? x 
+      end
+    end
+
+    def missing_post_parameters? required, supplied
+      error = nil
+      required.each do |k,v|
+        supplied_required = required[k] & supplied if k != 'required_if'
+        case k
+        when 'required'
+          error = k if supplied_required != required[k]
+        when 'exclusive'
+          error = k + '_too_few' if supplied_required.length < 1
+          error = k + '_too_many' if supplied_required.length > 1
+        when 'one_required'
+          error = k if supplied_required.length < 1
+        when 'required_if'
+          required[k].each do |key,val|
+            error = k if supplied.include? key and !supplied.include? val
+          end
+        end
+      end
+      error
+    end
+
+    def url_parameters_error required, supplied
+      if required.is_a? Hash
+        get_dynamic_url_error(required, supplied)
+      else
+        "requires #{required}. You're missing #{required-supplied}."
+      end
+    end
+
+    def get_dynamic_url_error required, supplied
+      error = "requires 1 of #{required.length} options: "
+      required.keys.each_with_index do |x,i|
+        error << "(#{i+1}) #{required[x]} "
+      end
+      error
+    end
+
+    def post_parameters_error required, supplied
+      error_type = missing_post_parameters? required, supplied
+      e = 'exclusive' if error_type == 'exclusive_too_few' or error_type == 'exclusive_too_many'
+      e ||= error_type
+
+      case error_type
+      when 'required'
+        "requires POST parameters #{required[e]}. You're missing #{required[e]-supplied}."
+      when 'exclusive_too_few'
+        "requires one of these POST parameters: #{required[e]}."
+      when 'exclusive_too_many'
+        supplied_required = required[e] & supplied
+        supplied_required_string = supplied_required.join(' AND ')
+        "allows only one of these POST parameters #{required[e]}. You used #{supplied_required_string}."
+      when 'one_required'
+        "requires at least one of the following POST parameters: #{required[e]}."
+      when 'required_if'
+        required[e].each do |k,v|
+          if supplied.include? k and !supplied.include? v
+            return "requires POST parameter #{v} when you use POST parameter #{k}."
+          end
+        end
+      end
+    end
+
+    def auth_error auth_required, auth_supplied
+      if auth_required == 'user-id' and !auth_supplied
+        "requires user auth_token and auth_secret, unless you include [\"user-id\"]."
+      elsif auth_required != 'user-id'
+        "requires user auth_token and auth_secret."
+      end
+    end
+
+    def build_request consumer_key, consumer_secret, auth_token, auth_secret
+      fitbit = Fitbit::Api.new :fitbit, consumer_key, consumer_secret
+      OAuth::AccessToken.new fitbit.consumer, auth_token, auth_secret
+    end
+
+    def send_api_request params, fitbit, access_token
+      http_method = fitbit['http_method']
+      request_url = build_url(params, fitbit, http_method)
+      request_headers = get_request_headers(params, fitbit) if fitbit['request_headers']
+
+      if http_method == 'get' or http_method == 'delete'
+        access_token.request( http_method, "http://api.fitbit.com#{request_url}", request_headers )
+      else
+        access_token.request( http_method, "http://api.fitbit.com#{request_url}", "",  request_headers )
+      end
+    end
+
+    def build_url params, fitbit, http_method
+      api_version = @@api_version
+      api_url_resources = get_url_resources(params, fitbit)
+      api_format = get_response_format(params['response-format'])
+      api_post_parameters = get_post_parameters(params, fitbit) if http_method == 'post'
+      api_query = uri_encode_query(params['query'])
+
+      "/#{api_version}/#{api_url_resources}.#{api_format}#{api_query}#{api_post_parameters}"
+    end
+
+    def get_post_parameters params, fitbit
+      return nil if is_subscription? params['api-method']
+      not_post_parameters = ['request_headers', 'url_parameters']
+      ignore = ['api-method', 'response-format']
+      not_post_parameters.each do |x|
+        fitbit[x].each { |y| ignore.push(y) } if fitbit[x] 
+      end
+      post_parameters = params.select { |k,v| !ignore.include? k }
+
+      "?" + OAuth::Helper.normalize(post_parameters)
+    end
+    
+    def get_request_headers params, fitbit
+      request_headers = fitbit['request_headers']
+      params.select { |k,v| request_headers.include? k }
+    end
+
+    def get_url_resources params, fitbit
+      params_keys = params.keys
+      api_ids = get_url_parameters(fitbit['url_parameters'], params_keys) 
+      api_resources = get_url_parameters(fitbit['resources'], params_keys)
+      dynamic_url = add_ids(params, api_ids, api_resources, fitbit['auth_required']) if api_ids or params['user-id']
+      dynamic_url ||= api_resources
+      dynamic_url.join("/")
+    end
+
+    def add_ids params, api_ids, api_resources, auth_required
+      api_resources_copy = api_resources.dup
+      api_resources_copy.each_with_index do |x, i|
+        id = x.delete "<>"
+
+        if x == '-' and auth_required == 'user-id' and params['user-id']
+          api_resources_copy[i] = params['user-id']
+        elsif id == 'collection-path' and params[id] == 'all'
+          api_resources_copy.delete(x)
+        elsif id == 'subscription-id' and params['collection-path'] != 'all'
+          api_resources_copy[i] = params[id] + "-" + params['collection-path']
+          api_resources_copy.delete('<collection-path>')
+        elsif api_ids and api_ids.include? id and !api_ids.include? x 
+          api_resources_copy[i] = params[id]
+        end
+      end
+    end
+
+    def is_subscription? api_method
+      api_method == 'api-create-subscription' or api_method == 'api-delete-subscription'
+    end
+
+    def get_response_format api_format
+      api_format ? api_format.downcase : 'xml'
+    end
+
+    def uri_encode_query query
+      query ? "?" + OAuth::Helper.normalize({ 'query' => query }) : ""
+    end
+
+    @@api_version = 1
+
+    @@fitbit_methods = {
+      'api-accept-invite' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['accept'],
+        },
+        'url_parameters'      => ['from-user-id'],
+        'resources'           => ['user', '-', 'friends', 'invitations', '<from-user-id>'],
+      },
+      'api-add-favorite-activity' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'url_parameters'      => ['activity-id'],
+        'resources'           => ['user', '-', 'activities', 'favorite', '<activity-id>'],
+      },
+      'api-add-favorite-food' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'url_parameters'      => ['food-id'],
+        'resources'           => ['user', '-', 'foods', 'log', 'favorite', '<food-id>'],
+      },
+      'api-browse-activities' => {
+        'auth_required'       => false,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['activities'],
+      },
+      'api-config-friends-leaderboard' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['hideMeFromLeaderboard'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'friends', 'leaderboard'],
+      },
+      'api-create-food' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['name', 'defaultFoodMeasurementUnitId', 'defaultServingSize', 'calories'],
+        },
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['foods'],
+      },
+      'api-create-invite' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     =>  {
+          'exlusive' => ['invitedUserEmail', 'invitedUserId'],
+        },
+        'resources'           => ['user', '-', 'friends', 'invitations'],
+      },
+      'api-create-subscription' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'url_parameters'      => ['collection-path', 'subscription-id'],
+        'request_headers'     => ['X-Fitbit-Subscriber-Id'],
+        'resources'           => ['user', '-', '<collection-path>', 'apiSubscriptions', '<subscription-id>', '<collection-path>']
+      },
+      'api-delete-activity-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['activity-log-id'],
+        'resources'           => ['user', '-', 'activities', '<activity-log-id>'],
+      },
+      'api-delete-blood-pressure-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['bp-log-id'],
+        'resources'           => ['user', '-', 'bp', '<bp-log-id>'],
+      },
+      'api-delete-body-fat-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['body-fat-log-id'],
+        'resources'           => ['user', '-', 'body', 'log', 'fat', '<body-fat-log-id>'],
+      },
+      'api-delete-body-weight-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['body-weight-log-id'],
+        'resources'           => ['user', '-', 'body', 'log', 'weight', '<body-weight-log-id>'],
+      },
+      'api-delete-favorite-activity' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['activity-id'],
+        'resources'           => ['user', '-', 'activities', 'favorite', '<activity-id>'],
+      },
+      'api-delete-favorite-food' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['food-id'],
+        'resources'           => ['user', '-', 'foods', 'log', 'favorite', '<food-id>'],
+      },
+      'api-delete-food-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['food-log-id'],
+        'resources'           => ['user', '-', 'foods', 'log', '<food-log-id>'],
+      },
+      'api-delete-heart-rate-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['heart-log-id'],
+        'resources'           => ['user', '-', 'heart', '<heart-log-id>'],
+      },
+      'api-delete-sleep-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['sleep-log-id'],
+        'resources'           => ['user', '-', 'sleep', '<sleep-log-id>'],
+      },
+      'api-delete-subscription' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'delete',
+        'url_parameters'      => ['collection-path', 'subscription-id'],
+        'resources'           => ['user', '-', '<collection-path>', 'apiSubscriptions', '<subscription-id>', '<collection-path>']
+      },
+      'api-delete-water-log' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['water-log-id'],
+        'resources'           => ['user', '-', 'foods', 'log', 'water', '<water-log-id>'],
+      },
+      'api-devices-add-alarm' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['time', 'enabled', 'recurring', 'weekDays'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => ['device-id'],
+        'resources'           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms'],
+      },
+      'api-devices-delete-alarm' => {
+        'auth_required'       => true,
+        'http_method'         => 'delete',
+        'url_parameters'      => ['device-id', 'alarm-id'],
+        'resources'           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms', '<alarm-id>'],
+      },
+      'api-devices-get-alarms' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'url_parameters'      => ['device-id'],
+        'resources'           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms'],
+      },
+      'api-devices-update-alarm' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['time', 'enabled', 'recurring', 'weekDays', 'snoozeLength', 'snoozeCount'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => ['device-id', 'alarm-id'],
+        'resources'           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms', '<alarm-id>'],
+      },
+      'api-get-activities' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale', 'Accept-Language'],
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'activities', 'date', '<date>'],
+      },
+      'api-get-activity' => {
+        'auth_required'       => false,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'url_parameters'      => ['activity-id'],
+        'resources'           => ['activities', '<activity-id>'],
+      },
+      'api-get-activity-daily-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'goals', 'daily'],
+      },
+      'api-get-activity-stats' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'activities'],
+      },
+      'api-get-activity-weekly-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'goals', 'weekly'],
+      },
+      'api-get-badges' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'badges'],
+      },
+      'api-get-blood-pressure' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'bp', 'date', '<date>'],
+      },
+      'api-get-body-fat' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'url_parameters'      => {
+          'date'      => ['date'],
+          'end-date'  => ['base-date', 'end-date'],
+          'period'    => ['base-date', 'period'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => {
+          'date'      => ['user', '-', 'body', 'log', 'fat', 'date', '<date>'],
+          'end-date'  => ['user', '-', 'body', 'log', 'fat', 'date', '<base-date>', '<end-date>'],
+          'period'    => ['user', '-', 'body', 'log', 'fat', 'date', '<base-date>', '<period>'],
+        }
+      },
+      'api-get-body-fat-goal' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'resources'           => ['user', '-', 'body', 'log', 'fat', 'goal'],
+      },
+      'api-get-body-measurements' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'body', 'date', '<date>'],
+      },
+      'api-get-body-weight' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => {
+          'date'      => ['date'],
+          'end-date'  => ['base-date', 'end-date'],
+          'period'    => ['base-date', 'period'],
+        },
+        'resources'           => {
+          'date'      => ['user', '-', 'body', 'log', 'weight', 'date', '<date>'],
+          'end-date'  => ['user', '-', 'body', 'log', 'weight', 'date', '<base-date>', '<end-date>'],
+          'period'    => ['user', '-', 'body', 'log', 'weight', 'date', '<base-date>', '<period>'],
+        }
+      },
+      'api-get-body-weight-goal' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'body', 'log', 'weight', 'goal'],
+      },
+      'api-get-device' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'url_parameters'      => ['device-id'],
+        'resources'           => ['user', '-', 'devices', '<device-id>'],
+      },
+      'api-get-devices' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'resources'           => ['user', '-', 'devices'],
+      },
+      'api-get-favorite-activities' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'activities', 'favorite'],
+      },
+      'api-get-favorite-foods' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'resources'           => ['user', '-', 'foods', 'log', 'favorite'],
+      },
+      'api-get-food' => {
+        'auth_required'       => false,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'url_parameters'      => ['food-id'],
+        'resources'           => ['foods', '<food-id>'],
+      },
+      'api-get-food-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'resources'           => ['user', '-', 'foods', 'log', 'goal'],
+      },
+      'api-get-foods' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'foods', 'log', 'date', '<date>'],
+      },
+      'api-get-food-units' => {
+        'auth_required'       => false,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['foods', 'units'],
+      },
+      'api-get-frequent-activities' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale', 'Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'frequent'],
+      },
+      'api-get-frequent-foods' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'foods', 'log', 'frequent'],
+      },
+      'api-get-friends' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'friends'],
+      },
+      'api-get-friends-leaderboard' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'friends', 'leaderboard'],
+      },
+      'api-get-glucose' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'glucose', 'date', '<date>'],
+      },
+      'api-get-heart-rate' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'heart', 'date', '<date>'],
+      },
+      'api-get-invites' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'resources'           => ['user', '-', 'friends', 'invitations'],
+      },
+      'api-get-meals' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'meals'],
+      },
+      'api-get-recent-activities' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale', 'Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'recent'],
+      },
+      'api-get-recent-foods' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'foods', 'log', 'recent'],
+      },
+      'api-get-sleep' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'sleep', 'date', '<date>'],
+      },
+      'api-get-time-series' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => {
+          'end-date'  => ['base-date', 'end-date', 'resource-path'],
+          'period'    => ['base-date', 'period', 'resource-path'],
+        },
+        'resources'           => {
+          'end-date'  => ['user', '-', '<resource-path>', 'date', '<base-date>', '<end-date>'],
+          'period'    => ['user', '-', '<resource-path>', 'date', '<base-date>', '<period>'],
+        },
+      },
+      'api-get-user-info' => {
+        'auth_required'       => 'user-id',
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'profile'],
+      },
+      'api-get-water' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Language'],
+        'url_parameters'      => ['date'],
+        'resources'           => ['user', '-', 'foods', 'log', 'water', 'date', '<date>'],
+      },
+      'api-log-activity' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'exclusive' => ['activityId', 'activityName'], 
+          'required'  => ['startTime', 'durationMillis', 'date'],
+          'required_if'  => { 'activityName' => 'manualCalories' },
+        },
+        'request_headers'     => ['Accept-Locale', 'Accept-Language'],
+        'resources'           => ['user', '-', 'activities'],
+      },
+      'api-log-blood-pressure' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['systolic', 'diastolic', 'date'],
+        },
+        'resources'           => ['user', '-', 'bp'],
+      },
+      'api-log-body-fat' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['fat', 'date'],
+        },
+        'resources'           => ['user', '-', 'body', 'log', 'fat'],
+      },
+      'api-log-body-measurements' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['date'],
+          'one_required' => ['bicep','calf','chest','fat','forearm','hips','neck','thigh','waist','weight'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'body'],
+      },
+      'api-log-body-weight' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['weight', 'date'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'body', 'log', 'weight'],
+      },
+      'api-log-food' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'exclusive' => ['foodId', 'foodName'], 
+          'required'  => ['mealTypeId', 'unitId', 'amount', 'date'],
+        },
+        'request_headers'     => ['Accept-Locale'],
+        'resources'           => ['user', '-', 'foods', 'log'],
+      },
+      'api-log-glucose' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'exclusive' => ['hbac1c', 'tracker'], 
+          'required'  => ['date'],
+          'required_if'  => { 'tracker' => 'glucose' },
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'glucose'],
+      },
+      'api-log-heart-rate' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['tracker', 'heartRate', 'date'],
+        },
+        'resources'           => ['user', '-', 'heart'],
+      },
+      'api-log-sleep' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['startTime', 'duration', 'date'],
+        },
+        'resources'           => ['user', '-', 'sleep'],
+      },
+      'api-log-water' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['amount', 'date'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'foods', 'log', 'water'],
+      },
+      'api-search-foods' => {
+        'auth_required'       => true,
+        'http_method'         => 'get',
+        'request_headers'     => ['Accept-Locale'],
+        'url_parameters'      => ['query'],
+        'resources'           => ['foods', 'search'],
+      },
+      'api-update-activity-daily-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'one_required' => ['caloriesOut','activeMinutes','floors','distance','steps'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'goals', 'daily'],
+      },
+      'api-update-activity-weekly-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'one_required' => ['steps','distance','floors'],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'activities', 'goals', 'weekly'],
+      },
+      'api-update-fat-goal' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['fat'],
+        },
+        'resources'           => ['user', '-', 'body', 'log', 'fat', 'goal'],
+      },
+      'api-update-food-goals' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'exclusive' => ['calories', 'intensity'],
+        },
+        'request_headers'     => ['Accept-Locale', 'Accept-Language'],
+        'resources'           => ['user', '-', 'foods', 'log', 'goal'],
+      },
+      'api-update-user-info' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'one_required' => [
+          'gender','birthday','height','nickname','aboutMe','fullname','country','state','city',
+          'strideLengthWalking','strideLengthRunning','weightUnit','heightUnit','waterUnit','glucoseUnit',
+          'timezone','foodsLocale','locale','localeLang','localeCountry'
+          ],
+        },
+        'request_headers'     => ['Accept-Language'],
+        'resources'           => ['user', '-', 'profile'],
+      },
+      'api-update-weight-goal' => {
+        'auth_required'       => true,
+        'http_method'         => 'post',
+        'post_parameters'     => {
+          'required' => ['startDate', 'startWeight'],
+        },
+        'resources'           => ['user', '-', 'body', 'log', 'weight', 'goal'],
+      },
+    }
+
+  end
+end

data/lib/fitbit-omni-api.rb

@@ -0,0 +1,3 @@
+require 'fitbit-omni-api/version'
+require 'omniauth/strategies/fitbit'
+require 'api/fitbit_api'

data/lib/fitbit-omni-api/version.rb

@@ -0,0 +1,7 @@
+module OmniAuth
+  module Fitbit
+    module Api
+      VERSION = "0.0.1"
+    end
+  end
+end

data/lib/omniauth/strategies/fitbit.rb

@@ -0,0 +1,49 @@
+require 'omniauth'
+require 'omniauth/strategies/oauth'
+
+module OmniAuth
+  module Strategies
+    class Fitbit < OmniAuth::Strategies::OAuth
+
+      option :name, "fitbit"
+
+      option :client_options, {
+          :site               => 'http://api.fitbit.com',
+          :request_token_path => '/oauth/request_token',
+          :access_token_path  => '/oauth/access_token',
+          :authorize_path     => '/oauth/authorize'
+      }
+
+      uid do
+        access_token.params['encoded_user_id']
+      end
+
+      info do
+        {
+            :full_name    => raw_info['user']['fullName'],
+            :display_name => raw_info['user']['displayName'],
+            :nickname     => raw_info['user']['nickname'],
+            :gender       => raw_info['user']['gender'],
+            :about_me     => raw_info['user']['aboutMe'],
+            :city         => raw_info['user']['city'],
+            :state        => raw_info['user']['state'],
+            :country      => raw_info['user']['country'],
+            :dob          => !raw_info['user']['dateOfBirth'].empty? ? Date.strptime(raw_info['user']['dateOfBirth'], '%Y-%m-%d'):nil,
+            :member_since => Date.strptime(raw_info['user']['memberSince'], '%Y-%m-%d'),
+            :locale       => raw_info['user']['locale'],
+            :timezone     => raw_info['user']['timezone']
+        }
+      end
+
+      extra do
+        { 
+            :raw_info => raw_info
+        }
+      end
+
+      def raw_info
+        @raw_info ||= MultiJson.load(access_token.get('http://api.fitbit.com/1/user/-/profile.json').body)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: fitbit-omni-api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- TK Gospodinov
+- Scott McGrath
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: omniauth-oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: multi_xml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: OmniAuth strategy for Fitbit, plus api wrapper
+email:
+- tk@gospodinov.net
+- Scott McGrat
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/api/fitbit_api.rb
+- lib/fitbit-omni-api/version.rb
+- lib/fitbit-omni-api.rb
+- lib/omniauth/strategies/fitbit.rb
+- LICENSE.md
+- Rakefile
+- README.md
+homepage: http://github.com/scrawlon/fitbit-omni-api
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: OmniAuth strategy for Fitbit, plus api wrapper
+test_files: []