Add characters endpoint

Allows users to query multiple characters simultaneously by ID

Author: mattantonelli

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    xivapi (0.2.1)
+    xivapi (0.2.2)
       rest-client (~> 2.0.2)
 
 GEM

lib/xivapi/request.rb

@@ -97,6 +97,15 @@ def character(id: nil, all_data: false, poll: false, columns: [])
     request_cached(self, "character/#{id}", :character, params, poll)
   end
 
+  # @param ids [String, Array<Integer>] Character IDs
+  # @param all_data [true, false] Return the full set of character data
+  # @param columns [String, Array <String>] One or more columns to limit results to
+  # @return [Array<OpenStruct>] The requested characters
+  def characters(ids: nil, all_data: false, columns: [])
+    body = { ids: [*ids].join(','), data: all_data ? ALL_CHARACTER_DATA : nil, columns: [*columns].join(',') }
+    request(self, 'characters', {}, body)
+  end
+
   # @param name [String] Character name
   # @param server [String] Character server
   # @param columns [String, Array <String>] One or more columns to limit results to

lib/xivapi/version.rb

@@ -1,4 +1,4 @@
 module XIVAPI
   # Gem version
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end