Added Link Route & Error Codes

zph · zph · commit ee2725839c01 · 2013-05-16T23:03:29.000-04:00
diff --git a/README.md b/README.md
@@ -33,15 +33,15 @@ Or install it yourself as:
 * User
 * Profiles (:get)
 * Updates (:get)
+* Links
+* Info
+* Error Codes
 
 #### Not Implemented
 
 * Authentication (Try OAuth-buffer)
 * Profiles (:post)
 * Updates (:post & optional params)
-* Links
-* Info
-* Error Codes
 * Optional params for get requests
 
 ## Contributing
diff --git a/lib/buff.rb b/lib/buff.rb
@@ -1,12 +1,15 @@
 require "httparty"
 require "json"
 require "rash"
+require "CSV"
 
 require "buff/version"
 require "buff/core"
 require "buff/user"
 require "buff/profile"
 require "buff/update"
+require "buff/link"
+require "buff/error"
 
 module Buff
 
@@ -17,6 +20,8 @@ class Update   < Hashie::Mash; end
   class Updates  < Hashie::Mash; end
   class Interaction < Hashie::Mash; end
   class Interactions < Hashie::Mash; end
+  class Link < Hashie::Mash; end
+  class Info < Hashie::Mash; end
 
   class Schedule < Hashie::Mash; end
   Schedules = Class.new(Array) do
@@ -28,13 +33,17 @@ def dump
   InvalidIdLength = Class.new(ArgumentError)
   InvalidIdContent = Class.new(ArgumentError)
   MissingStatus = Class.new(ArgumentError)
+  APIError = Class.new(StandardError)
+  UnauthorizeRequest = Class.new(StandardError)
 
   class Client
     include HTTParty
     include Core
     include User
     include Profile
     include Update
+    include Link
+    include Error
 
     attr_accessor :access_token, :auth_query
 
@@ -48,6 +57,11 @@ def initialize(access_token)
         }
       }
     end
+
+    def info
+      response = get("/info/configuration.json")
+      Buff::Info.new(response)
+    end
   end
 end
 
diff --git a/lib/buff/core.rb b/lib/buff/core.rb
@@ -3,9 +3,70 @@ class Client
     module Core
       API_VERSION = "1"
 
+      attr_reader :error_table
+
       def get(path, options=auth_query)
-        self.class.get(path, options)
+        response = self.class.get(path, options)
+        case response.code
+        when 200
+          response
+        # when 401
+        #   raise Buff::UnauthorizeRequest
+        else
+          handle_response_code(response)
+        end
+      end
+
+      def handle_response_code(response)
+        error = Hashie::Mash.new( response.body )
+        if ERROR_TABLE[error.code]
+          error_explanation = "Buffer API Error Code: #{error.code}\n"
+          error_explanation += "Description: #{error.error}"
+        else
+          error_explanation = "Buffer API Unknown Error in Response"
+        end
+
+        raise Buff::APIError, error_explanation
       end
+
+      def self.error_table
+        @error_table ||= ERROR_TABLE
+      end
+
+      ERROR_TABLE = {
+         "403"=>"Permission denied.",
+         "404"=>"Endpoint not found.",
+         "405"=>"Method not allowed.",
+         "1000"=>"An unknown error occurred.",
+         "1001"=>"Access token required.",
+         "1002"=>"Not within application scope.",
+         "1003"=>"Parameter not recognized.",
+         "1004"=>"Required parameter missing.",
+         "1005"=>"Unsupported response format.",
+         "1006"=>"Parameter value not within bounds.",
+         "1010"=>"Profile could not be found.",
+         "1011"=>"No authorization to access profile.",
+         "1012"=>"Profile did not save successfully.",
+         "1013"=>"Profile schedule limit reached.",
+         "1014"=>"Profile limit for user has been reached.",
+         "1015"=>"Profile could not be destroyed.",
+         "1020"=>"Update could not be found.",
+         "1021"=>"No authorization to access update.",
+         "1022"=>"Update did not save successfully.",
+         "1023"=>"Update limit for profile has been reached.",
+         "1024"=>"Update limit for team profile has been reached.",
+         "1025"=>"Update was recently posted, can't post duplicate content.",
+         "1026"=>"Update must be in error status to requeue.",
+         "1028"=>"Update soft limit for profile reached.",
+         "1029"=>"Event type not supported.",
+         "1030"=>"Media filetype not supported.",
+         "1031"=>"Media filesize out of acceptable range.",
+         "1032"=>"Unable to post image to LinkedIn group(s).",
+         "1042"=>"User did not save successfully.",
+         "1050"=>"Client could not be found.",
+         "1051"=>"No authorization to access client."
+      }
+
     end
   end
 end
diff --git a/lib/buff/error.rb b/lib/buff/error.rb
@@ -0,0 +1,4 @@
+module Buff
+  module Error
+  end
+end
diff --git a/lib/buff/link.rb b/lib/buff/link.rb
@@ -0,0 +1,10 @@
+module Buff
+  class Client
+    module Link
+      def link(url)
+        response = get("/links/shares.json?url=#{url}")
+        Buff::Link.new(response)
+      end
+    end
+  end
+end
diff --git a/spec/lib/buff/link_spec.rb b/spec/lib/buff/link_spec.rb
@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe Buff::Client do
+  describe "#link" do
+    let(:client) { Buff::Client.new("some_token") }
+    let(:url) { %q{http://bufferapp.com} }
+
+    before do
+      stub_request(:get, "https://api.bufferapp.com/1/links/shares.json?access_token=some_token&url=http://bufferapp.com").
+        to_return(fixture('link.txt'))
+    end
+
+    it "connects to the correct endpoint" do
+      client.link(url)
+    end
+
+    it "parses the shares of a link" do
+      client.link(url).shares.should eq(47348)
+    end
+
+  end
+end

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +module Buff
 +  module Error
 +  end
 +end