instagram-innonate 0.8

data/lib/instagram/client/geographies.rb

@@ -0,0 +1,29 @@
+module Instagram
+  class Client
+    # Defines methods related to real-time geographies
+    module Geographies
+      # Returns a list of recent media items for a given real-time geography
+      #
+      # @overload geography_recent_media(id, options={})
+      #   @param user [Integer] A geography ID from a real-time subscription.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [Integer] :count (nil) Limit the number of results returned
+      #   @option options [Integer] :min_id (nil) Return media before this min_id
+      #   @option options [Integer] :max_id (nil) Return media after this max_id
+      #   @option options [Integer] :min_timestamp (nil) Return media after this UNIX timestamp
+      #   @option options [Integer] :max_timestamp (nil) Return media before this UNIX timestamp
+      #   @return [Hashie::Mash]
+      #   @example Return a list of the most recent media items taken within a specific geography
+      #     Instagram.geography_recent_media(514276)
+      # @see http://instagram.com/developer/endpoints/geographies/
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      def geography_recent_media(id, *args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        response = get("geographies/#{id}/media/recent", options)
+        response["data"]
+      end
+    end
+  end
+end

data/lib/instagram/client/likes.rb

@@ -0,0 +1,58 @@
+module Instagram
+  class Client
+    # Defines methods related to likes
+    module Likes
+      # Returns a list of users who like a given media item ID
+      #
+      # @overload media_likes(id)
+      #   @param media [Integer] An Instagram media item ID
+      #   @return [Hashie::Mash] A list of users.
+      #   @example Returns a list of users who like the media item of ID 1234
+      #     Instagram.media_likes(777)
+      # @format :json
+      # @authenticated true
+      #
+      #   If getting this data of a protected user, you must be authenticated (and be allowed to see that user).
+      # @rate_limited true
+      # @see TODO:docs url
+      def media_likes(id, *args)
+        response = get("media/#{id}/likes")
+        response["data"]
+      end
+
+      # Issues a like by the currently authenticated user, for a given media item ID
+      #
+      # @overload like_media(id, text)
+      #   @param id [Integer] An Instagram media item ID
+      #   @return [nil]
+      #   @example Like media item with ID 777
+      #     Instagram.like_media(777)
+      # @format :json
+      # @authenticated true
+      #
+      #   If getting this data of a protected user, you must be authenticated (and be allowed to see that user).
+      # @rate_limited true
+      # @see TODO:docs url
+      def like_media(id, options={})
+        response = post("media/#{id}/likes", options)
+        response["data"]
+      end
+
+      # Removes the like on a givem media item ID for the currently authenticated user
+      #
+      # @overload unlike_media(id)
+      #   @param media_id [Integer] An Instagram media item ID.
+      #   @return [nil]
+      #   @example Remove the like for the currently authenticated user on the media item with the ID of 777
+      #     Instagram.unlike_media(777)
+      # @format :json
+      # @authenticated true
+      # @rate_limited true
+      # @see TODO:docs url
+      def unlike_media(id, options={})
+        response = delete("media/#{id}/likes", options)
+        response["data"]
+      end
+    end
+  end
+end

data/lib/instagram/client/locations.rb

@@ -0,0 +1,59 @@
+module Instagram
+  class Client
+    # Defines methods related to media items
+    module Locations
+      # Returns extended information of a given Instagram location
+      #
+      # @overload location(id)
+      #   @param location [Integer] An Instagram location ID
+      #   @return [Hashie::Mash] The requested location.
+      #   @example Return extended information for the Instagram office
+      #     Instagram.location(514276)
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      # @see TODO:docs url
+      def location(id, *args)
+        response = get("locations/#{id}")
+        response["data"]
+      end
+
+      # Returns a list of recent media items for a given Instagram location
+      #
+      # @overload location_recent_media(id, options={})
+      #   @param user [Integer] An Instagram location 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 the most recent media items taken at the Instagram office
+      #     Instagram.location_recent_media(514276)
+      # @see TODO:docs url
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      def location_recent_media(id, *args)
+        options = args.last.is_a?(Hash) ? args.pop : {}
+        response = get("locations/#{id}/media/recent", options)
+        response
+      end
+
+      # Returns Instagram locations within proximity of given lat,lng
+      #
+      # @param lat [String] A given latitude in decimal format
+      # @param lng [String] A given longitude in decimal format
+      # @option options [Integer] :count The number of media items to retrieve.
+      # @return [Array]
+      # @example Return locations around 37.7808851, -122.3948632 (164 S Park, SF, CA USA)
+      #   Instagram.location_search("37.7808851", "-122.3948632")
+      # @see TODO:doc url
+      # @format :json
+      # @authenticated false
+      # @rate_limited true
+      def location_search(lat, lng, options={})
+        response = get('locations/search', options.merge(:lat => lat, :lng => lng))
+        response["data"]
+      end
+    end
+  end
+end

data/lib/instagram/client/media.rb

@@ -0,0 +1,63 @@
+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 TODO:docs url
+      def media_item(*args)
+        id = args.first || 'self'
+        response = get("media/#{id}")
+        response["data"]
+      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 TODO:docs url
+      # @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["data"]
+      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 [Array]
+      # @example Return media around 37.7808851, -122.3948632 (164 S Park, SF, CA USA)
+      #   Instagram.media_search("37.7808851", "-122.3948632")
+      # @see TODO:doc url
+      # @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,157 @@
+require 'openssl'
+
+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["data"]
+      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))
+        response["data"]
+      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 [nil]
+      #   @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))
+        response["data"]
+      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[:signature]
+          if !client_secret
+            raise ArgumentError, "client_secret must be set during configure"
+          end
+          digest = OpenSSL::Digest::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 TODO:docs url
+      def tag(tag, *args)
+        response = get("tags/#{tag}")
+        response["data"]
+      end
+
+      # Returns a list of recent media items for a given Instagram tag
+      #
+      # @overload tag_recent_media(tag, options={})
+      #   @param user [String] An Instagram tag name.
+      #   @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 the most recent media items tagged "cat"
+      #     Instagram.tag_recent_media('cat')
+      # @see TODO:docs url
+      # @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)
+        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 [Array]
+      # @see TODO:doc url
+      # @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["data"]
+      end
+    end
+  end
+end

data/lib/instagram/client/users.rb

@@ -0,0 +1,309 @@
+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 TODO:docs url
+      def user(*args)
+        id = args.first || 'self'
+        response = get("users/#{id}")
+        response["data"]
+      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 [Array]
+      # @see TODO:doc url
+      # @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["data"]
+      end
+
+      # Returns a list of users whom a given user follows
+      #
+      # @overload 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 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 TODO:docs url
+      # @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["data"]
+      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 TODO:docs url
+    # @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["data"]
+    end
+
+    # Returns a list of users whom a given user is followed by
+    #
+    # @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 TODO:docs url
+    # @format :json
+    # @authenticated truei
+    # @rate_limited true
+    def user_requested_by()
+      response = get("users/self/requested-by")
+      response["data"]
+    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 [Array]
+    #   @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["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def user_relationship(id, options={})
+      response = get("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def follow_user(id, options={})
+      options["action"] = "follow"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def unfollow_user(id, options={})
+      options["action"] = "unfollow"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def block_user(id, options={})
+      options["action"] = "block"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def unblock_user(id, options={})
+      options["action"] = "unblock"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def approve_user(id, options={})
+      options["action"] = "approve"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    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/
+    # @format :json
+    # @authenticated true
+    # @rate_limited true
+    def deny_user(id, options={})
+      options["action"] = "deny"
+      response = post("users/#{id}/relationship", options)
+      response["data"]
+    end
+  end
+end