fitbit-omni-api 0.0.2 → 0.0.3

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NDNjZWY5ZGM5OWJmOWY1ZjI1ZDg5NGY1ODdiNjI1M2I1NzBmM2I3ZQ==
+  data.tar.gz: !binary |-
+    ZDk4NGZjYzI2MjE1MmQxOTgzOWIyOTNhMzllODBmYjJkZjRlOGVhYg==
+SHA512:
+  metadata.gz: !binary |-
+    NjNlNTQ4ZmE2NTQyNWNiOGUxNGVhYmM4MmQ1ZmZiMjViZjFjZmE3NTg4YWI4
+    MmQ4ZWFlYTI5OTAwMDdlNjIyMGRmMGRhMzg4ZWM0ZWIzNzdjYmE5Njg5YWYy
+    YmM1MjQ2YWYwMjk3MzMzNzU4NTQwZGM3ODA0NDliZTVmZDA5YmQ=
+  data.tar.gz: !binary |-
+    ZDkwZjc5MjQxMDVlNTY0NjczNTBkZThlZTA3NDQ0NmNmMjI3MDM5MGZhY2M4
+    NjNjOWUzZTY1ZTliMjlhMDFmZTU3YTg0MWFlODZhNmNiMzdkODdhNmU3Nzli
+    NzQ4ZWI1YTY3NTMzOTI3ZjExZmUxMWJiMTI5NTk5OTExMTIzOGI=

data/LICENSE.md

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

data/README.md

@@ -1,75 +1,51 @@
-# Fitbit OmniAuth Strategy
+# Fitbit-Omni-Api
 
-This gem is an OmniAuth 1.0+ Strategy for the [Fitbit API](https://wiki.fitbit.com/display/API/OAuth+Authentication+in+the+Fitbit+API).
+This gem uses the [OmniAuth-Fitbit Strategy](https://github.com/tkgospodinov/omniauth-fitbit) for authentication.
+See that repo for more info.
 
-## Usage
+## Accessing the Fitbit API
+### There are breaking changes in this version.
 
-Add the strategy to your `Gemfile`:
+### Installation
 
+Add the gem to your Gemfile
 ```ruby
 gem 'fitbit-omni-api'
 ```
 
-Then integrate the strategy into your middleware:
+The gem class is simply 'Fitbit::Api' and Fitbit Api requests are made with the 'Fitbit::Api.request' method.
 
-```ruby
-use OmniAuth::Builder do
-  provider :fitbit, 'consumer_key', 'consumer_secret'
-end
-```
+Each API request needs:
+* Your Fitbit consumer_key and consumer_secret (acquired from [dev.fitbit.com](http://dev.fitbit.cpm))
+* A params Hash with api-method and required parameters 
+* Optionally, Fitbit auth tokens or user-id if required 
 
-In Rails, create a new file under config/initializers called omniauth.rb to plug the strategy into your middleware stack.
+This is the structure of an authenticated API call: 
 
 ```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(
+Fitbit::Api.request(
   'consumer_key',
   'consumer_secret',
-  params,
+  params = { 'api-method' => 'api-method-here', 'start-time' => '00:00' }
   'auth_token',
   'auth_secret'
 )
 ```
 
-This gem supports the Fitbit Resource Access API and the Fitbit Subscriptions API.
+This gem supports the Fitbit Resource Access API, Fitbit Subscriptions API and Fitbit Partner 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:
+the API-Search-Foods method requires _'api-version'_, _'query'_ and _'response-format'_, plus there's an optional
+_'Accept-Locale'_  Request Header parameter.
+
+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(
+  request = Fitbit::Api.request(
     'consumer_key',
     'consumer_secret',
-    params,
+    params={'api-method'=>'api-search-foods','query'=>'buffalo chicken','Accept-Locale'=>'en_US'}
     'auth_token',
     'auth_secret'
   )
@@ -77,17 +53,18 @@ def fitbit_foods_search
 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).
+### Fitbit Subscriptions API
+Use API-Create-Subscription and API-Delete-Subscription API methods to to access the Subscription API.
+Consult the Subscription API docs to discover the required parameters.
+To subscribe to ALL of a user's changes, make 'collection-path' = 'all'.
+
+### Fitbit Partner API
+These features are only accessible with approved Fitbit developer accounts. 
 
-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'.
+### Defaults:
+* 'api-version' defaults to '1'
+* 'response-format' defaults to 'xml'
 
-## Copyright
+### Copyright
 
-Copyright (c) 2012 TK Gospodinov, (c) Scott McGrath 2013. See [LICENSE](https://github.com/tkgospodinov/omniauth-fitbit/blob/master/LICENSE.md) for details.
+Copyright (c) 2012 TK Gospodinov, (c) Scott McGrath 2013. See [LICENSE](https://github.com/scrawlon/fitbit-omni-api/blob/master/LICENSE.md) for details.

data/lib/api/fitbit_api.rb

@@ -1,767 +1,776 @@
 require 'omniauth-fitbit'
 
 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
+  class Api < OmniAuth::Strategies::OAuth
+    class << self 
+      def request consumer_key, consumer_secret, params, auth_token=nil, auth_secret=nil
+        begin 
+          fitbit_api_method = get_api_method(params['api-method'])
+          verify_api_call(params, fitbit_api_method, auth_token, auth_secret)
+        rescue => e
+          raise e
+        end
+        access_token = build_request(consumer_key, consumer_secret, auth_token, auth_secret)
+        send_api_request(params, fitbit_api_method, access_token)
+      end
 
-    def get_fitbit_methods
-      @@fitbit_methods
-    end
+      def get_fitbit_methods
+        @@fitbit_methods
+      end
 
-    private 
+      private 
 
-    def get_lowercase_api_method params
-      params['api-method'] ||= nil
-      params['api-method'].downcase!
-      params
-    end
+      def get_api_method api_method
+        api_method.downcase! if api_method.is_a? String
+        @@fitbit_methods[api_method]
+      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." 
+      def verify_api_call params, fitbit_api_method, auth_token, auth_secret
+        error = get_error_message(params.keys, fitbit_api_method, auth_token, auth_secret)
+        raise "#{params['api-method']} #{error}" if error
       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'))
+      def get_error_message params_keys, fitbit_api_method, auth_token, auth_secret
+        error_types = [:post_parameters, :url_parameters, :auth_required]
+        if !fitbit_api_method
+          "is not a valid Fitbit API method."
+        else
+          error_types.each do |x|
+            case x
+            when :post_parameters
+              error = missing_post_parameters_error(fitbit_api_method[x], params_keys)
+            when :url_parameters
+              error = missing_url_parameters_error(fitbit_api_method[x], params_keys)
+            when :auth_required
+              error = missing_auth_tokens_error(fitbit_api_method[x], params_keys, auth_token, auth_secret)
+            end
+            return error if error
+          end
+          nil
+        end
       end
-    end
 
-    def missing_url_parameters? required, supplied
-      url_parameters = get_url_parameters(required, supplied)
-      url_parameters and url_parameters & supplied != url_parameters
-    end
+      def missing_post_parameters_error required, supplied
+        required = {} unless required.is_a? Hash
+        required.each do |k,v|
+          supplied_required = v & supplied unless k == 'required_if'
+          case k
+          when 'required'
+            error = missing_required_post_parameters_error(v, supplied, supplied_required)
+          when 'exclusive'
+            error = missing_exclusive_post_parameters_error(v, supplied_required)
+          when 'one_required'
+            error = missing_one_required_post_parameters_error(v, supplied_required)
+          when 'required_if'
+            error = missing_required_if_post_parameters_error(v, supplied)
+          end
+          return error if error
+        end
+        nil
+      end
 
-    def get_url_parameters required, supplied
-      if required.is_a? Hash
-        get_dynamic_url_parameters(required, supplied)
-      else
-        required
+      def missing_required_post_parameters_error required, supplied, supplied_required
+        "requires POST parameters #{required}. You're missing #{required-supplied}." if supplied_required != required 
       end
-    end
 
-    def get_dynamic_url_parameters required, supplied
-      required.keys.each { |k| return required[k] if supplied.include? k }
-    end
+      def missing_exclusive_post_parameters_error required, supplied_required
+        total_supplied = supplied_required.length
+        if total_supplied < 1
+          "requires one of these POST parameters: #{required}." 
+        elsif total_supplied > 1
+          "allows only one of these POST parameters: #{required}. You used #{supplied_required.join(' AND ')}." 
+        else
+          nil
+        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
+      def missing_one_required_post_parameters_error required, supplied_required
+        "requires at least one of the following POST parameters: #{required}." if supplied_required.length < 1
+      end
+
+      def missing_required_if_post_parameters_error required, supplied
+        required.each do |k,v|
+          return "requires POST parameter #{v} when you use POST parameter #{k}." if supplied.include? k and !supplied.include? v
         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}."
+      def missing_auth_tokens_error auth_required, params_keys, auth_token, auth_secret
+        error = "requires user auth_token and auth_secret"
+        no_auth_tokens = !auth_token or !auth_secret
+        if !auth_required
+          nil
+        elsif no_auth_tokens and auth_required != 'user-id'
+          "#{error}."
+        elsif no_auth_tokens and auth_required == 'user-id'
+          !params_keys.include?('user-id') ? "#{error}, unless you include [\"user-id\"]." : nil
+        end
       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]} "
+      def missing_url_parameters_error required, supplied
+        if required.is_a? Hash
+          get_dynamic_url_error(required, supplied)
+        else
+          required = get_url_parameters_variables(required)
+          required - supplied != [] ? "requires #{required}. You're missing #{required-supplied}." : nil
+        end
       end
-      error << "You supplied: #{supplied}"
-    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
+      def get_dynamic_url_error required, supplied
+        if missing_dynamic_url_parameters?(required, supplied)
+          required = required.select { |k,v| k != 'optional' }
+          options = required.keys.map.with_index(1) { |x,i| "(#{i}) #{get_url_parameters_variables(required[x])}" }.join(' ')
+          "requires 1 of #{required.length} options: #{options}. You supplied: #{supplied}."
+        else
+          nil
         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."
+      def missing_dynamic_url_parameters? required, supplied
+        required = get_dynamic_url_parameters(required, supplied)
+        required = get_url_parameters_variables(required) if required
+        required & supplied != required  
       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 get_dynamic_url_parameters required, supplied
+        optional = get_optional_url_parameters(required, supplied)
+        required.keys.each { |k| return required[k] + optional if supplied.include? k }
+        nil
+      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']
+      def get_url_parameters_variables url_parameters
+        url_parameters.select { |x| x.include? "<" }.map { |x| x.delete "<>" } if has_url_variables? url_parameters
+      end
 
-      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 )
+      def has_url_variables? url_parameters
+        url_parameters.each{ |x| return true if x.include? "<" }
       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'])
+      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
 
-      "/#{api_version}/#{api_url_resources}.#{api_format}#{api_query}#{api_post_parameters}"
-    end
+      def get_url_parameters required, supplied
+        required.is_a?(Hash) ? get_dynamic_url_parameters(required, supplied) : required
+      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] 
+      def get_optional_url_parameters required, supplied
+        optional = [] unless required['optional']
+        optional ? optional : required['optional'].select { |k,v| supplied.include? k }.values.flatten
       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 insert_dynamic_url_parameters params, url_parameters, auth_required
+        url_parameters.map do |x|
+          url_variable = x.delete "<>"
 
-    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
+          if x == '-'
+            insert_user_id(auth_required, params['user-id'])
+          elsif params.include? url_variable and !params.include? x
+            is_subscription_variable?(url_variable) ? insert_subscription_variable(params, url_variable) : params[url_variable]
+          else
+            x
+          end
+        end - [nil]
+      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
+      def insert_user_id auth_required, user_id
+        (auth_required == 'user-id' and user_id) ? user_id : '-'
       end
-    end
 
-    def is_subscription? api_method
-      api_method == 'api-create-subscription' or api_method == 'api-delete-subscription'
-    end
+      def is_subscription_variable? url_variable
+        subscription_variables = ['subscription-id', 'collection-path']
+        subscription_variables.include? url_variable
+      end
 
-    def get_response_format api_format
-      api_format ? api_format.downcase : 'xml'
-    end
+      def insert_subscription_variable params, url_variable
+        if url_variable == 'subscription-id'
+          params['collection-path'] == 'all' ? params[url_variable] : "#{params[url_variable]}-#{params['collection-path']}"
+        else
+          params['collection-path'] != 'all' ? params[url_variable] : nil
+        end
+      end
 
-    def uri_encode_query query
-      query ? "?" + OAuth::Helper.normalize({ 'query' => query }) : ""
-    end
+      def send_api_request params, fitbit, access_token
+        http_method = fitbit[:http_method]
+        request_headers = get_request_headers(params, fitbit[:request_headers])
+        request_url = build_url(params, fitbit, http_method)
 
-    @@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>'],
+        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 get_request_headers params, request_headers
+        request_headers ? params.select { |k,v| request_headers.include? k } : nil
+      end
+
+      def build_url params, fitbit_api_method, http_method
+        api = {
+          :version            => params['api_version'] ? params['api_version'] : @@api_version,
+          :url_resources      => get_url_resources(params, fitbit_api_method),
+          :response_format    => params['response-format'] ? params['response-format'].downcase : 'xml',
+          :post_parameters    => get_post_parameters(params, fitbit_api_method, http_method),
+          :query              => uri_encode_query(params['query']),
         }
-      },
-      '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'],
-      },
-    }
+        "/#{api[:version]}/#{api[:url_resources]}.#{api[:response_format]}#{api[:query]}#{api[:post_parameters]}"
+      end
+
+      def get_url_resources params, fitbit_api_method
+        url_parameters = get_url_parameters(fitbit_api_method[:url_parameters], params.keys)
+        if has_url_variables? url_parameters or params['user-id'] 
+          url_parameters = insert_dynamic_url_parameters(params, url_parameters, fitbit_api_method[:auth_required])
+        end
+        url_parameters.join("/")
+      end
+
+      def get_post_parameters params, fitbit, http_method
+        if http_method == 'post' and !is_subscription? params['api-method']
+          post_parameters = params.select { |k,v| fitbit[:post_parameters].values.flatten.include? k }
+          "?#{OAuth::Helper.normalize(post_parameters)}"
+        else
+          nil
+        end
+      end
+
+      def uri_encode_query query
+        query ? "?#{OAuth::Helper.normalize({ 'query' => query })}" : ""
+      end
+
+      def is_subscription? api_method
+        api_method == 'api-create-subscription' or api_method == 'api-delete-subscription'
+      end
 
+      @@api_version = 1
+
+      @@fitbit_methods = {
+        'api-accept-invite' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['accept'],
+          },
+          :url_parameters           => ['user', '-', 'friends', 'invitations', '<from-user-id>'],
+        },
+        'api-add-favorite-activity' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :url_parameters           => ['user', '-', 'activities', 'favorite', '<activity-id>'],
+        },
+        'api-add-favorite-food' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :url_parameters           => ['user', '-', 'foods', 'log', 'favorite', '<food-id>'],
+        },
+        'api-browse-activities' => {
+          :auth_required       => false,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['activities'],
+        },
+        'api-config-friends-leaderboard' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['hideMeFromLeaderboard'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'friends', 'leaderboard'],
+        },
+        'api-create-food' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['name', 'defaultFoodMeasurementUnitId', 'defaultServingSize', 'calories'],
+            'optional' => ['formType', 'description'],
+          },
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['foods'],
+        },
+        'api-create-invite' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     =>  {
+            'exclusive' => ['invitedUserEmail', 'invitedUserId'],
+          },
+          :url_parameters           => ['user', '-', 'friends', 'invitations'],
+        },
+        'api-create-subscription' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :request_headers     => ['X-Fitbit-Subscriber-Id'],
+          :url_parameters           => ['user', '-', '<collection-path>', 'apiSubscriptions', '<subscription-id>']
+        },
+        'api-delete-activity-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'activities', '<activity-log-id>'],
+        },
+        'api-delete-blood-pressure-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'bp', '<bp-log-id>'],
+        },
+        'api-delete-body-fat-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'body', 'log', 'fat', '<body-fat-log-id>'],
+        },
+        'api-delete-body-weight-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'body', 'log', 'weight', '<body-weight-log-id>'],
+        },
+        'api-delete-favorite-activity' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'activities', 'favorite', '<activity-id>'],
+        },
+        'api-delete-favorite-food' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'foods', 'log', 'favorite', '<food-id>'],
+        },
+        'api-delete-food-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'foods', 'log', '<food-log-id>'],
+        },
+        'api-delete-heart-rate-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'heart', '<heart-log-id>'],
+        },
+        'api-delete-sleep-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'sleep', '<sleep-log-id>'],
+        },
+        'api-delete-subscription' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', '<collection-path>', 'apiSubscriptions', '<subscription-id>']
+        },
+        'api-delete-water-log' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'foods', 'log', 'water', '<water-log-id>'],
+        },
+        'api-devices-add-alarm' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['time', 'enabled', 'recurring', 'weekDays'],
+            'optional' => ['label', 'snoozeLength', 'snoozeCount', 'vibe'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms'],
+        },
+        'api-devices-delete-alarm' => {
+          :auth_required       => true,
+          :http_method         => 'delete',
+          :url_parameters           => ['user', '-', 'devices', 'tracker', '<device-id>', 'alarms', '<alarm-id>'],
+        },
+        'api-devices-get-alarms' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['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'],
+            'optional' => ['label', 'vibe'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['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           => ['user', '-', 'activities', 'date', '<date>'],
+        },
+        'api-get-activity' => {
+          :auth_required       => false,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['activities', '<activity-id>'],
+        },
+        'api-get-activity-daily-goals' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities', 'goals', 'daily'],
+        },
+        'api-get-activity-stats' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities'],
+        },
+        'api-get-activity-weekly-goals' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities', 'goals', 'weekly'],
+        },
+        'api-get-badges' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'badges'],
+        },
+        'api-get-blood-pressure' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'bp', 'date', '<date>'],
+        },
+        'api-get-body-fat' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => {
+            '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',
+          :url_parameters           => ['user', '-', 'body', 'log', 'fat', 'goal'],
+        },
+        'api-get-body-measurements' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'body', 'date', '<date>'],
+        },
+        'api-get-body-weight' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => {
+            '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'],
+          :url_parameters           => ['user', '-', 'body', 'log', 'weight', 'goal'],
+        },
+        'api-get-device' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'devices', '<device-id>'],
+        },
+        'api-get-devices' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'devices'],
+        },
+        'api-get-favorite-activities' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'activities', 'favorite'],
+        },
+        'api-get-favorite-foods' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'foods', 'log', 'favorite'],
+        },
+        'api-get-food' => {
+          :auth_required       => false,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['foods', '<food-id>'],
+        },
+        'api-get-food-goals' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'foods', 'log', 'goal'],
+        },
+        'api-get-foods' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'foods', 'log', 'date', '<date>'],
+        },
+        'api-get-food-units' => {
+          :auth_required       => false,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['foods', 'units'],
+        },
+        'api-get-frequent-activities' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale', 'Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities', 'frequent'],
+        },
+        'api-get-frequent-foods' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'foods', 'log', 'frequent'],
+        },
+        'api-get-friends' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'friends'],
+        },
+        'api-get-friends-leaderboard' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'friends', 'leaderboard'],
+        },
+        'api-get-glucose' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'glucose', 'date', '<date>'],
+        },
+        'api-get-heart-rate' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'heart', 'date', '<date>'],
+        },
+        'api-get-intraday-time-series' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => {
+            'end-date'  => ['user', '-', '<resource-path>', 'date', '<base-date>', '<end-date>'],
+            'period'    => ['user', '-', '<resource-path>', 'date', '<base-date>', '<period>'],
+            'optional'  => {
+              'detail-level'  => [ '<detail-level>' ],
+              'start-time'    => ['time', '<start-time>', '<end-time>']
+            },
+          },
+        },
+        'api-get-invites' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'friends', 'invitations'],
+        },
+        'api-get-meals' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'meals'],
+        },
+        'api-get-recent-activities' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale', 'Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities', 'recent'],
+        },
+        'api-get-recent-foods' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'foods', 'log', 'recent'],
+        },
+        'api-get-sleep' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :url_parameters           => ['user', '-', 'sleep', 'date', '<date>'],
+        },
+        'api-get-time-series' => {
+          :auth_required       => 'user-id',
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => {
+            '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'],
+          :url_parameters           => ['user', '-', 'profile'],
+        },
+        'api-get-water' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['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' },
+            'optional'  => ['distanceUnit'],
+          },
+          :request_headers     => ['Accept-Locale', 'Accept-Language'],
+          :url_parameters           => ['user', '-', 'activities'],
+        },
+        'api-log-blood-pressure' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['systolic', 'diastolic', 'date'],
+            'optional' => ['time'],
+          },
+          :url_parameters           => ['user', '-', 'bp'],
+        },
+        'api-log-body-fat' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['fat', 'date'],
+            'optional' => ['time'],
+          },
+          :url_parameters           => ['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'],
+          :url_parameters           => ['user', '-', 'body'],
+        },
+        'api-log-body-weight' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['weight', 'date'],
+            'optional' => ['time'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'body', 'log', 'weight'],
+        },
+        'api-log-food' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'exclusive' => ['foodId', 'foodName'], 
+            'required'  => ['mealTypeId', 'unitId', 'amount', 'date'],
+            'optional'  => ['brandName', 'calories', 'favorite'],
+          },
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['user', '-', 'foods', 'log'],
+        },
+        'api-log-glucose' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'exclusive' => ['hbac1c', 'tracker'], 
+            'required'  => ['date'],
+            'required_if'  => { 'tracker' => 'glucose' },
+            'optional' => ['time'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'glucose'],
+        },
+        'api-log-heart-rate' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['tracker', 'heartRate', 'date'],
+            'optional' => ['time'],
+          },
+          :url_parameters           => ['user', '-', 'heart'],
+        },
+        'api-log-sleep' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['startTime', 'duration', 'date'],
+          },
+          :url_parameters           => ['user', '-', 'sleep'],
+        },
+        'api-log-water' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['amount', 'date'],
+            'optional' => ['unit'],
+          },
+          :request_headers     => ['Accept-Language'],
+          :url_parameters           => ['user', '-', 'foods', 'log', 'water'],
+        },
+        'api-search-foods' => {
+          :auth_required       => true,
+          :http_method         => 'get',
+          :request_headers     => ['Accept-Locale'],
+          :url_parameters           => ['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'],
+          :url_parameters           => ['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'],
+          :url_parameters           => ['user', '-', 'activities', 'goals', 'weekly'],
+        },
+        'api-update-fat-goal' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['fat'],
+          },
+          :url_parameters           => ['user', '-', 'body', 'log', 'fat', 'goal'],
+        },
+        'api-update-food-goals' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'exclusive' => ['calories', 'intensity'],
+            'optional'  => ['personalized'],
+          },
+          :request_headers     => ['Accept-Locale', 'Accept-Language'],
+          :url_parameters           => ['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'],
+          :url_parameters           => ['user', '-', 'profile'],
+        },
+        'api-update-weight-goal' => {
+          :auth_required       => true,
+          :http_method         => 'post',
+          :post_parameters     => {
+            'required' => ['startDate', 'startWeight'],
+            'optional' => ['weight'],
+          },
+          :url_parameters           => ['user', '-', 'body', 'log', 'weight', 'goal'],
+        },
+      }
+    end
   end
 end