Add webhook support. Add polling support

Author: David Ashman

lib/convert_api.rb

@@ -28,6 +28,13 @@ def convert(to_format, params, from_format: nil, conversion_timeout: nil)
     Task.new(from_format, to_format, params, conversion_timeout: conversion_timeout).run
   end
 
+  # Poll ConvertAPI for job status
+  # Raises ClientError with status code 202 if the job is not complete yet
+  # Raises ClientError with status code 404 if the job is not found
+  def poll(job_id)
+    Result.new(client.get("async/job/#{job_id}"))
+  end
+
   def user
     client.get('user')
   end

lib/convert_api/client.rb

@@ -28,6 +28,11 @@ class Client
       'Accept' => 'application/json'
     }
 
+    # Parameters that are always on the URL, even for POST
+    POST_URL_PARAMS = [
+      :WebHook
+    ].freeze
+
     def get(path, params = {}, options = {})
       handle_response do
         request = Net::HTTP::Get.new(request_uri(path, params), DEFAULT_HEADERS)
@@ -38,7 +43,7 @@ def get(path, params = {}, options = {})
 
     def post(path, params, options = {})
       handle_response do
-        request = Net::HTTP::Post.new(request_uri(path), DEFAULT_HEADERS)
+        request = Net::HTTP::Post.new(request_uri(path, post_url_params(params)), DEFAULT_HEADERS)
         request.form_data = build_form_data(params)
 
         http(options).request(request)
@@ -113,16 +118,22 @@ def build_form_data(params)
       data = {}
 
       params.each do |key, value|
-        if value.is_a?(Array)
-          value.each_with_index { |v, i| data["#{key}[#{i}]"] = v }
-        else
-          data[key] = value
+        unless POST_URL_PARAMS.include?(key)
+          if value.is_a?(Array)
+            value.each_with_index { |v, i| data["#{key}[#{i}]"] = v }
+          else
+            data[key] = value
+          end
         end
       end
 
       data
     end
 
+    def post_url_params(params)
+      params.select { |k, v| POST_URL_PARAMS.include?(k) }
+    end
+
     def base_uri
       config.base_uri
     end