extendi-instagram 2.0.0

data/lib/instagram/client/media.rb

@@ -0,0 +1,82 @@
+module Instagram
+  class Client
+    # Defines methods related to media items
+    module Media
+      # Returns extended information of a given media item
+      #
+      # @overload media_item(id)
+      #   @param user [Integer] An Instagram media item ID
+      #   @return [Hashie::Mash] The requested media item.
+      #   @example Return extended information for media item 1234
+      #     Instagram.media_item(1324)
+      # @format :json
+      # @authenticated false unless requesting media from a protected user
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @rate_limited true
+      # @see http://instagram.com/developer/endpoints/media/#get_media
+      def media_item(*args)
+        id = args.first || 'self'
+        response = get("media/#{id}")
+        response
+      end
+
+      # Returns extended information of a given media item
+      #
+      # @overload media_shortcode(shortcode)
+      #   @param shortcode [String] An Instagram media item shortcode
+      #   @return [Hashie::Mash] The requested media item.
+      #   @example Return extended information for media item with shortcode 'D'
+      #     Instagram.media_shortcode('D')
+      # @format none
+      # @authenticated false unless requesting media from a protected user
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @rate_limited true
+      # @see http://instagram.com/developer/endpoints/media/#get_media_by_shortcode
+      def media_shortcode(*args)
+        shortcode = args.first
+        response = get("media/shortcode/#{shortcode}", {}, false, false, true)
+        response
+      end
+
+      # Returns a list of the overall most popular media
+      #
+      # @overload media_popular(options={})
+      #   @param options [Hash] A customizable set of options.
+      #   @return [Hashie::Mash]
+      #   @example Returns a list of the overall most popular media
+      #     Instagram.media_popular
+      # @see http://instagram.com/developer/endpoints/media/#get_media_popular
+      # @format :json
+      # @authenticated false unless requesting it from a protected user
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @rate_limited true
+      def media_popular(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        id = args.first || "self"
+        response = get("media/popular", options)
+        response
+      end
+
+      # Returns media items within proximity of given lat,lng
+      #
+      # @param lat [String] A given latitude in decimal format
+      # @param lng [String] A given longitude in decimal format
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :count The number of media items to retrieve.
+      # @return [Hashie::Mash] A list of matching media
+      # @example Return media around 37.7808851, -122.3948632 (164 S Park, SF, CA USA)
+      #   Instagram.media_search("37.7808851", "-122.3948632")
+      # @see http://instagram.com/developer/endpoints/media/#get_media_search
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      def media_search(lat, lng, options={})
+        response = get('media/search', options.merge(:lat => lat, :lng => lng))
+        response
+      end
+    end
+  end
+end

data/lib/instagram/client/subscriptions.rb

@@ -0,0 +1,211 @@
+require 'openssl'
+require 'multi_json'
+
+module Instagram
+  class Client
+    # Defines methods related to real-time
+    module Subscriptions
+      # Returns a list of active real-time subscriptions
+      #
+      # @overload subscriptions(options={})
+      #   @return [Hashie::Mash] The list of subscriptions.
+      #   @example Returns a list of subscriptions for the authenticated application
+      #     Instagram.subscriptions
+      # @format :json
+      # @authenticated true
+      #
+      #   Requires client_secret to be set on the client or passed in options
+      # @rate_limited true
+      # @see https://api.instagram.com/developer/realtime/
+      def subscriptions(options={})
+        response = get("subscriptions", options.merge(:client_secret => client_secret))
+        response
+      end
+
+      # Creates a real-time subscription
+      #
+      # @overload create_subscription(options={})
+      #   @param options [Hash] A set of parameters
+      #   @option options [String] :object The object you'd like to subscribe to (user, tag, location or geography)
+      #   @option options [String] :callback_url The subscription callback URL
+      #   @option options [String] :aspect The aspect of the object you'd like to subscribe to (in this case, "media").
+      #   @option options [String, Integer] :object_id When specifying a location or tag use the location's ID or tag name respectively
+      #   @option options [String, Float] :lat The center latitude of an area, used when subscribing to a geography object
+      #   @option options [String, Float] :lng The center longitude of an area, used when subscribing to a geography object
+      #   @option options [String, Integer] :radius The distance in meters you'd like to capture around a given point
+      # @overload create_subscription(object, callback_url, aspect="media", options={})
+      #   @param object [String] The object you'd like to subscribe to (user, tag, location or geography)
+      #   @param callback_url [String] The subscription callback URL
+      #   @param aspect [String] he aspect of the object you'd like to subscribe to (in this case, "media").
+      #   @param options [Hash] Addition options and parameters
+      #   @option options [String, Integer] :object_id When specifying a location or tag use the location's ID or tag name respectively
+      #   @option options [String, Float] :lat The center latitude of an area, used when subscribing to a geography object
+      #   @option options [String, Float] :lng The center longitude of an area, used when subscribing to a geography object
+      #   @option options [String, Integer] :radius The distance in meters you'd like to capture around a given point
+      #
+      #     Note that we only support "media" at this time, but we might support other types of subscriptions in the future.
+      #   @return [Hashie::Mash] The subscription created.
+      #   @example Creates a new subscription to receive notifications for user media changes.
+      #     Instagram.create_subscription("user", "http://example.com/instagram/callback")
+      # @format :json
+      # @authenticated true
+      #
+      #   Requires client_secret to be set on the client or passed in options
+      # @rate_limited true
+      # @see https://api.instagram.com/developer/realtime/
+      def create_subscription(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        object = args.shift
+        callback_url = args.shift
+        aspect = args.shift
+        options.tap {|o|
+          o[:object] = object unless object.nil?
+          o[:callback_url] = callback_url unless callback_url.nil?
+          o[:aspect] = aspect || o[:aspect] || "media"
+        }
+        response = post("subscriptions", options.merge(:client_secret => client_secret), signature=true)
+        response
+      end
+
+      # Deletes a real-time subscription
+      #
+      # @overload delete_subscription(options={})
+      #   @param options [Hash] Addition options and parameters
+      #   @option options [Integer] :subscription_id The subscription's ID
+      #   @option options [String] :object When specified will remove all subscriptions of this object type, unless an :object_id is also specified (user, tag, location or geography)
+      #   @option options [String, Integer] :object_id When specifying :object, inlcude an :object_id to only remove subscriptions of that object and object_id
+      # @overload delete_subscription(subscription_id, options={})
+      #   @param subscription_id [Integer] The subscription's ID
+      #   @param options [Hash] Addition options and parameters
+      #   @option options [String] :object When specified will remove all subscriptions of this object type, unless an :object_id is also specified (user, tag, location or geography)
+      #   @option options [String, Integer] :object_id When specifying :object, inlcude an :object_id to only remove subscriptions of that object and object_id
+      #   @return [Hashie::Mash]
+      #   @example Deletes an application's user change subscription
+      #     Instagram.delete_subscription(:object => "user")
+      # @format :json
+      # @authenticated true
+      #
+      #   Requires client_secret to be set on the client or passed in options
+      # @rate_limited true
+      # @see https://api.instagram.com/developer/realtime/
+      def delete_subscription(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        subscription_id = args.first
+        options.merge!(:id => subscription_id) if subscription_id
+        response = delete("subscriptions", options.merge(:client_secret => client_secret), signature=true)
+        response
+      end
+
+      # As a security measure (to prevent DDoS attacks), Instagram sends a verification request to your server
+      # after you request a subscription.
+      # This method parses the challenge params and makes sure the call is legitimate.
+      #
+      # @param params the request parameters sent by Instagram.  (You can pass in a Rails params hash.)
+      # @param verify_token the verify token sent in the {#subscribe subscription request}, if you provided one
+      #
+      # @yield verify_token if you need to compute the verification token
+      #                     (for instance, if your callback URL includes a record ID, which you look up
+      #                     and use to calculate a hash), you can pass meet_challenge a block, which
+      #                     will receive the verify_token received back from Instagram.
+      #
+      # @return the challenge string to be sent back to Instagram, or false if the request is invalid.
+      def meet_challenge(params, verify_token = nil, &verification_block)
+        if params["hub.mode"] == "subscribe" &&
+            # you can make sure this is legitimate through two ways
+            # if your store the token across the calls, you can pass in the token value
+            # and we'll make sure it matches
+            ((verify_token && params["hub.verify_token"] == verify_token) ||
+            # alternately, if you sent a specially-constructed value (such as a hash of various secret values)
+            # you can pass in a block, which we'll call with the verify_token sent by Instagram
+            # if it's legit, return anything that evaluates to true; otherwise, return nil or false
+            (verification_block && yield(params["hub.verify_token"])))
+          params["hub.challenge"]
+        else
+          false
+        end
+      end
+
+      # Public: As a security measure, all updates from Instagram are signed using
+      # X-Hub-Signature: XXXX where XXX is the sha1 of the json payload
+      # using your application secret as the key.
+      #
+      # Example:
+      #   # in Rails controller
+      #   def receive_update
+      #     if Instagram.validate_update(request.body, headers)
+      #       ...
+      #     else
+      #       render text: "not authorized", status: 401
+      #     end
+      #   end
+      def validate_update(body, headers)
+        unless client_secret
+          raise ArgumentError, "client_secret must be set during configure"
+        end
+
+        if request_signature = headers['X-Hub-Signature'] || headers['HTTP_X_HUB_SIGNATURE']
+          calculated_signature = OpenSSL::HMAC.hexdigest('sha1', client_secret, body)
+          calculated_signature == request_signature
+        end
+      end
+
+      # Process a subscription notification JSON payload
+      #
+      # @overload process_subscription(json, &block)
+      #   @param json [String] The JSON response received by the Instagram real-time server
+      #   @param block [Proc] A callable in which callbacks are defined
+      #   @option options [String] :signature Pass in an X-Hub-Signature to use for payload validation
+      #   @return [nil]
+      #   @example Process and handle a notification for a user media change
+      #     Instagram.process_subscription(params[:body]) do |handler|
+      #
+      #       handler.on_user_changed do |user_id, data|
+      #
+      #         user = User.by_instagram_id(user_id)
+      #         @client = Instagram.client(:access_token => _access_token_for_user(user))
+      #         latest_media = @client.user_recent_media[0]
+      #         user.media.create_with_hash(latest_media)
+      #       end
+      #
+      #     end
+      # @format :json
+      # @authenticated true
+      #
+      #   Requires client_secret to be set on the client or passed in options
+      # @rate_limited true
+      # @see https://api.instagram.com/developer/realtime/
+      def process_subscription(json, options={}, &block)
+        raise ArgumentError, "callbacks block expected" unless block_given?
+
+        if options.has_key?(:signature)
+          if !client_secret
+            raise ArgumentError, "client_secret must be set during configure"
+          end
+          digest = OpenSSL::Digest.new('sha1')
+          verify_signature = OpenSSL::HMAC.hexdigest(digest, client_secret, json)
+
+          if options[:signature] != verify_signature
+            raise Instagram::InvalidSignature, "invalid X-Hub-Signature does not match verify signature against client_secret"
+          end
+        end
+
+        payload = MultiJson.decode(json)
+        @changes = Hash.new { |h,k| h[k] = [] }
+        for change in payload
+          @changes[change['object']] << change
+        end
+        block.call(self)
+      end
+
+      [:user, :tag, :location, :geography].each do |object|
+        class_eval <<-RUBY_EVAL, __FILE__, __LINE__ +1
+          def on_#{object}_changed(&block)
+            for change in @changes['#{object}']
+              yield change.delete('object_id'), change
+            end
+          end
+        RUBY_EVAL
+      end
+    end
+  end
+end

data/lib/instagram/client/tags.rb

@@ -0,0 +1,59 @@
+module Instagram
+  class Client
+    # Defines methods related to tags
+    module Tags
+      # Returns extended information of a given Instagram tag
+      #
+      # @overload tag(tag)
+      #   @param tag [String] An Instagram tag name
+      #   @return [Hashie::Mash] The requested tag.
+      #   @example Return extended information for the tag "cat"
+      #     Instagram.tag('cat')
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      # @see http://instagram.com/developer/endpoints/tags/#get_tags
+      def tag(tag, *args)
+        response = get("tags/#{tag}")
+        response
+      end
+
+      # Returns a list of recent media items for a given Instagram tag
+      #
+      # @overload tag_recent_media(tag, options={})
+      #   @param tag-name [String] An Instagram tag name.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :max_tag_id (nil) Returns results with an ID less than (that is, older than) or equal to the specified ID. The value can be retrieved from the returned response via pagination.max_tag_id.
+      #   @option options [Integer] :min_tag_id (nil) Returns results with an ID greater than (that is, newer than) or equal to the specified ID. The value can be retrieved from the returned response via pagination.min_tag_id.
+      #   @return [Hashie::Mash]
+      #   @example Return a list of the most recent media items tagged "cat"
+      #     Instagram.tag_recent_media('cat')
+      # @see https://instagram.com/developer/endpoints/tags/#get_tags_media_recent
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      def tag_recent_media(id, *args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        response = get("tags/#{id}/media/recent", options, false, false, false)
+        response
+      end
+
+      # Returns a list of tags starting with the given search query
+      #
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      # @param query [String] The beginning or complete tag name to search for
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :count The number of media items to retrieve.
+      # @return [Hashie::Mash]
+      # @see http://instagram.com/developer/endpoints/tags/#get_tags_search
+      # @example Return tags that start with "cat"
+      #   Instagram.tag_search("cat")
+      def tag_search(query, options={})
+        response = get('tags/search', options.merge(:q => query))
+        response
+      end
+    end
+  end
+end

data/lib/instagram/client/users.rb

@@ -0,0 +1,310 @@
+module Instagram
+  class Client
+    # Defines methods related to users
+    module Users
+      # Returns extended information of a given user
+      #
+      # @overload user(id=nil, options={})
+      #   @param user [Integer] An Instagram user ID
+      #   @return [Hashie::Mash] The requested user.
+      #   @example Return extended information for @shayne
+      #     Instagram.user(20)
+      # @format :json
+      # @authenticated false unless requesting it from a protected user
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @rate_limited true
+      # @see http://instagram.com/developer/endpoints/users/#get_users
+      def user(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        id = args.first || 'self'
+        response = get("users/#{id}", options)
+        response
+      end
+
+      # Returns users that match the given query
+      #
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      # @param query [String] The search query to run against user search.
+      # @param options [Hash] A customizable set of options.
+      # @option options [Integer] :count The number of users to retrieve.
+      # @return [Hashie::Mash]
+      # @see http://instagram.com/developer/endpoints/users/#get_users_search
+      # @example Return users that match "Shayne Sweeney"
+      #   Instagram.user_search("Shayne Sweeney")
+      def user_search(query, options={})
+        response = get('users/search', options.merge(:q => query))
+        response
+      end
+
+      # Returns a list of users whom a given user follows
+      #
+      # @overload user_follows(id=nil, options={})
+      #   @param options [Hash] A customizable set of options.
+      #   @return [Hashie::Mash]
+      #   @example Returns a list of users the authenticated user follows
+      #     Instagram.user_follows
+      # @overload user_follows(id=nil, options={})
+      #   @param user [Integer] An Instagram user ID.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :cursor (nil) Breaks the results into pages. Provide values as returned in the response objects's next_cursor attribute to page forward in the list.
+      #   @option options [Integer] :count (nil) Limits the number of results returned per page.
+      #   @return [Hashie::Mash]
+      #   @example Return a list of users @mikeyk follows
+      #     Instagram.user_follows(4) # @mikeyk user ID being 4
+      # @see http://instagram.com/developer/endpoints/relationships/#get_users_follows
+      # @format :json
+      # @authenticated false unless requesting it from a protected user
+      #
+      #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+      # @rate_limited true
+      def user_follows(*args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        id = args.first || "self"
+        response = get("users/#{id}/follows", options)
+        response
+      end
+    end
+
+    # Returns a list of users whom a given user is followed by
+    #
+    # @overload user_followed_by(id=nil, options={})
+    #   @param options [Hash] A customizable set of options.
+    #   @return [Hashie::Mash]
+    #   @example Returns a list of users the authenticated user is followed by
+    #     Instagram.user_followed_by
+    # @overload user_followed_by(id=nil, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] A customizable set of options.
+    #   @option options [Integer] :cursor (nil) Breaks the results into pages. Provide values as returned in the response objects's next_cursor attribute to page forward in the list.
+    #   @option options [Integer] :count (nil) Limits the number of results returned per page.
+    #   @return [Hashie::Mash]
+    #   @example Return a list of users @mikeyk is followed by
+    #     Instagram.user_followed_by(4) # @mikeyk user ID being 4
+    # @see http://instagram.com/developer/endpoints/relationships/#get_users_followed_by
+    # @format :json
+    # @authenticated false unless requesting it from a protected user
+    #
+    #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+    # @rate_limited true
+    def user_followed_by(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      id = args.first || "self"
+      response = get("users/#{id}/followed-by", options)
+      response
+    end
+
+    # Returns a list of users who have requested the currently authorized user's permission to follow
+    #
+    # @overload user_requested_by()
+    #   @param options [Hash] A customizable set of options.
+    #   @return [Hashie::Mash]
+    #   @example Returns a list of users awaiting approval of a ollow request, for the authenticated user
+    #     Instagram.user_requested_by
+    # @overload user_requested_by()
+    #   @return [Hashie::Mash]
+    #   @example Return a list of users who have requested to follow the authenticated user
+    #     Instagram.user_requested_by()
+    # @see http://instagram.com/developer/endpoints/relationships/#get_incoming_requests
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def user_requested_by()
+      response = get("users/self/requested-by")
+      response
+    end
+
+    # Returns most recent media items from the currently authorized user's feed
+    #
+    # @overload user_media_feed(options={})
+    #   @param options [Hash] A customizable set of options.
+    #   @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
+    #   @option options [Integer] :min_id Return media later than this min_id
+    #   @option options [Integer] :count Specifies the number of records to retrieve, per page.
+    #   @return [Hashie::Mash]
+    #   @example Return most recent media images that would appear on @shayne's feed
+    #     Instagram.user_media_feed() # assuming @shayne is the authorized user
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    # @see http://instagram.com/developer/endpoints/users/#get_users_feed
+    def user_media_feed(*args)
+      options = args.first.is_a?(Hash) ? args.pop : {}
+      response = get('users/self/feed', options)
+      response
+    end
+
+    # Returns a list of recent media items for a given user
+    #
+    # @overload user_recent_media(options={})
+    #   @param options [Hash] A customizable set of options.
+    #   @return [Hashie::Mash]
+    #   @example Returns a list of recent media items for the currently authenticated user
+    #     Instagram.user_recent_media
+    # @overload user_recent_media(id=nil, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] A customizable set of options.
+    #   @option options [Integer] :max_id (nil) Returns results with an ID less than (that is, older than) or equal to the specified ID.
+    #   @option options [Integer] :count (nil) Limits the number of results returned per page.
+    #   @return [Hashie::Mash]
+    #   @example Return a list of media items taken by @mikeyk
+    #     Instagram.user_recent_media(4) # @mikeyk user ID being 4
+    # @see http://instagram.com/developer/endpoints/users/#get_users_media_recent
+    # @format :json
+    # @authenticated false unless requesting it from a protected user
+    #
+    #   If getting this data of a protected user, you must authenticate (and be allowed to see that user).
+    # @rate_limited true
+    def user_recent_media(*args)
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      id = args.first || "self"
+      response = get("users/#{id}/media/recent", options)
+      response
+    end
+
+    # Returns a list of media items liked by the current user
+    #
+    # @overload user_liked_media(options={})
+    #   @param options [Hash] A customizable set of options.
+    #   @option options [Integer] :max_like_id (nil) Returns results with an ID less than (that is, older than) or equal to the specified ID.
+    #   @option options [Integer] :count (nil) Limits the number of results returned per page.
+    #   @return [Hashie::Mash]
+    #   @example Returns a list of media items liked by the currently authenticated user
+    #     Instagram.user_liked_media
+    # @see http://instagram.com/developer/endpoints/users/#get_users_liked_feed
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def user_liked_media(options={})
+      response = get("users/self/media/liked", options)
+      response
+    end
+
+    # Returns information about the current user's relationship (follow/following/etc) to another user
+    #
+    # @overload user_relationship(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Return the relationship status between the currently authenticated user and @mikeyk
+    #     Instagram.user_relationship(4) # @mikeyk user ID being 4
+    # @see http://instagram.com/developer/endpoints/relationships/#get_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def user_relationship(id, options={})
+      response = get("users/#{id}/relationship", options)
+      response
+    end
+
+    # Create a follows relationship between the current user and the target user
+    #
+    # @overload follow_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Request the current user to follow the target user
+    #     Instagram.follow_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def follow_user(id, options={})
+      options[:action] = "follow"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+
+    # Destroy a follows relationship between the current user and the target user
+    #
+    # @overload unfollow_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Remove a follows relationship between the current user and the target user
+    #     Instagram.unfollow_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def unfollow_user(id, options={})
+      options[:action] = "unfollow"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+
+    # Block a relationship between the current user and the target user
+    #
+    # @overload unfollow_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Block a relationship between the current user and the target user
+    #     Instagram.block_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def block_user(id, options={})
+      options[:action] = "block"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+
+    # Remove a relationship block between the current user and the target user
+    #
+    # @overload unblock_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Remove a relationship block between the current user and the target user
+    #     Instagram.unblock_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def unblock_user(id, options={})
+      options[:action] = "unblock"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+
+    # Approve a relationship request between the current user and the target user
+    #
+    # @overload approve_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Approve a relationship request between the current user and the target user
+    #     Instagram.approve_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def approve_user(id, options={})
+      options[:action] = "approve"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+
+    # Deny a relationship request between the current user and the target user
+    #
+    # @overload deny_user(id, options={})
+    #   @param user [Integer] An Instagram user ID.
+    #   @param options [Hash] An optional options hash
+    #   @return [Hashie::Mash]
+    #   @example Deny a relationship request between the current user and the target user
+    #     Instagram.deny_user(4)
+    # @see http://instagram.com/developer/endpoints/relationships/#post_relationship
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def deny_user(id, options={})
+      options[:action] = "deny"
+      response = post("users/#{id}/relationship", options, signature=true)
+      response
+    end
+  end
+end