service.rb in open311-0.1.0

- old
+ new
@@ -1,21 +1,90 @@
 module Open311
   class Client
     module Service
       # Provide a list of acceptable 311 service request types and their associated service codes
       #
-      # @todo Overload the method to allow fetching of the authenticated user's screen name from configurati
       # @format :xml
       # @key false
       # @param options [Hash] A customizable set of options.
       # @return [Array]
       # @see http://wiki.open311.org/GeoReport_v2#GET_Service_List
       # @example Provide a list of acceptable 311 service request types and their associated service codes
       #   Open311.service_list
       def service_list(options={})
         options.merge!(:jurisdiction_id => jurisdiction)
-        response = get('dev/v2/services', options)
+        response = get('services', options)
         format.to_s.downcase == 'xml' ? response['services']['service'] : response
+      end
+
+      # @format :xml
+      # @key false
+      # @param id String the service code
+      # @param options [Hash] A customizable set of options.
+      # @return Hash
+      # @see http://wiki.open311.org/GeoReport_v2#GET_Service_Definition
+      # @example define attributes associated with a service code, i.e. 033
+      #   Open311.service_definition
+      def service_definition(id, options={})
+        options.merge!(:jurisdiction_id => jurisdiction)
+        response = get("services/#{id}", options)
+        format.to_s.downcase == 'xml' ? response['service_definition'] : response
+      end
+
+      # @format :xml
+      # @key false
+      # @param options [Hash] A customizable set of options.
+      # @return [Array]
+      # @see http://wiki.open311.org/GeoReport_v2#GET_Service_Requests
+      #   Open311.service_requests
+      def service_requests(options={})
+        options.merge!(:jurisdiction_id => jurisdiction)
+        response = get("requests", options)
+        if format.to_s.downcase == 'xml'
+          response.service_requests.request.map do |request|
+            ServiceRequest.new(request)
+          end
+        else
+          response
+        end
+      end
+
+      # @format :xml
+      # @key true
+      # @param options [Hash] A customizable set of options.
+      # @return Hash
+      # @see http://wiki.open311.org/GeoReport_v2#POST_Service_Request
+      #   Open311.post_service_request
+      def post_service_request(options={})
+        options.merge!(:jurisdiction_id => jurisdiction, :api_key => api_key)
+        response = post("requests", options)
+        format.to_s.downcase == 'xml' ? response['service_requests']['request'] : response
+      end
+
+      # @format :xml
+      # @key false
+      # @param id String of the service request id
+      # @param options [Hash] A customizable set of options.
+      # @return Hash
+      # @see http://wiki.open311.org/GeoReport_v2#GET_Service_Requests
+      #   Open311.get_service_request
+      def get_service_request(id, options={})
+        options.merge!(:jurisdiction_id => jurisdiction)
+        response = get("requests/#{id}", options)
+        format.to_s.downcase == 'xml' ? ServiceRequest.new(response.service_requests.request.first) : response
+      end
+
+      # @format :xml
+      # @key false
+      # @param token_id A token included in the response to .service_response request
+      # @param options [Hash] A customizable set of options.
+      # @return Array
+      # @see http://wiki.open311.org/GeoReport_v2#GET_request_id_from_a_token
+      #   Open311.request_id
+      def request_id(token_id, options = {})
+        options.merge!(:jurisdiction_id => jurisdiction)
+        response = get("tokens/#{token_id}", options)
+        format.to_s.downcase == 'xml' ? ServiceRequest.new(response.service_requests.request) : response
       end
     end
   end
 end