mediaburst 1.0.1 → 1.1.0

data/README.md

@@ -52,6 +52,18 @@ Check the response for errors:
 
 On error, the value of the key referenced by the number will equal the [error code][5] returned from Mediaburst.
 
+### Checking the Account's Credit
+
+Create an instance of the Mediaburst client:
+
+    client = Mediaburst::API.new('username', 'password')
+
+Request the credit amount
+
+    client.get_credit
+    => "150"
+
+Given invalid credentials, this method will return nil. If the server responds with anything other than a 200, a Mediaburst::ServerError exception is raised.
 
 ## Development
 

data/lib/mediaburst/api.rb

@@ -2,7 +2,8 @@ require 'nokogiri'
 require 'net/http'
 
 module Mediaburst
-  ENDPOINT = 'http://sms.message-platform.com/xml/send.aspx'
+  SEND_ENDPOINT = 'http://sms.message-platform.com/xml/send.aspx'
+  CREDIT_ENDPOINT = 'http://sms.message-platform.com/http/credit.aspx'
   
   # Thrown when an invalid request is made, 
   # e.g invalid credentials were used
@@ -18,6 +19,28 @@ module Mediaburst
     def initialize(u, p)
       @auth = {:username => u, :password => p}
     end
+    
+    
+    # Returns the about of credit left on a user account
+    #
+    # nil if there was a problem retrieving the value, and
+    # Throws an exception if the server didn't process 
+    # the request succesfully.
+    def get_credit
+      uri = URI.parse(CREDIT_ENDPOINT + "?username=#{@auth[:username]}&password=#{@auth[:password]}")
+      http = Net::HTTP.new(uri.host, uri.port)
+      request = Net::HTTP::Get.new(uri.request_uri)
+      request["Content-Type"] = "text/html"
+
+      response = http.request(request)
+      
+      case response
+      when Net::HTTPSuccess
+        return response.body.gsub!(/^Current Credit: ([0-9]+)/, '\1')
+      else
+        raise Mediaburst::ServerError, "Request failed: #{response}"
+      end
+    end
   
     # Takes a number or array of numbers and a content string
     # and sends to the mediaburst SMS API endpoint.
@@ -59,7 +82,7 @@ module Mediaburst
     # Send a request to the endpoint
     def send_request(request_body)
       # Create and send the request
-      uri = URI.parse(ENDPOINT)
+      uri = URI.parse(SEND_ENDPOINT)
       http = Net::HTTP.new(uri.host, uri.port)
       request = Net::HTTP::Post.new(uri.request_uri)
       request.body = request_body

data/lib/mediaburst/version.rb

@@ -1,3 +1,3 @@
 module Mediaburst
-  VERSION = '1.0.1'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: mediaburst
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 19
   prerelease: false
   segments: 
   - 1
-  - 0
   - 1
-  version: 1.0.1
+  - 0
+  version: 1.1.0
 platform: ruby
 authors: 
 - Matt Hall
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-02-25 00:00:00 +00:00
+date: 2011-08-10 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency