ipgeolocation_sdk 1.0.0

data/lib/ipgeolocation_sdk/api/ip_security_api.rb

@@ -0,0 +1,184 @@
+=begin
+#IPGeolocation.io - IP intelligence products
+
+#Ipgeolocation provides a set of APIs to make ip based decisions.
+
+The version of the OpenAPI document: 2.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.13.0
+
+=end
+
+require 'cgi'
+
+module IpgeolocationSdk
+  class IPSecurityApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # The Bulk IP Security Lookup API can provide security details for up to `50,000` bulk IPs. This API also has parameters to customize the response, just like the single IP Security Lookup API.
+    # @param get_bulk_ip_geolocation_request [GetBulkIpGeolocationRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :include Include optional objects like `location`, `network`.  Use comma-separated values. Example: include=location,network 
+    # @option opts [String] :fields Get specific fields, objects from the response.
+    # @option opts [String] :excludes Exclude specific fields, objects from the response.
+    # @option opts [String] :output Desired output format.
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter `lang`. Multi language feature is available only for `paid users`.
+    # @return [Array<GetBulkIpSecurityInfo200ResponseInner>]
+    def get_bulk_ip_security_info(opts = {})
+      data, _status_code, _headers = get_bulk_ip_security_info_with_http_info(opts)
+      data
+    end
+
+    # The Bulk IP Security Lookup API can provide security details for up to &#x60;50,000&#x60; bulk IPs. This API also has parameters to customize the response, just like the single IP Security Lookup API.
+    # @param get_bulk_ip_geolocation_request [GetBulkIpGeolocationRequest] 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :include Include optional objects like &#x60;location&#x60;, &#x60;network&#x60;.  Use comma-separated values. Example: include&#x3D;location,network 
+    # @option opts [String] :fields Get specific fields, objects from the response.
+    # @option opts [String] :excludes Exclude specific fields, objects from the response.
+    # @option opts [String] :output Desired output format.
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter &#x60;lang&#x60;. Multi language feature is available only for &#x60;paid users&#x60;.
+    # @return [Array<(Array<GetBulkIpSecurityInfo200ResponseInner>, Integer, Hash)>] Array<GetBulkIpSecurityInfo200ResponseInner> data, response status code and response headers
+    def get_bulk_ip_security_info_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityApi.get_bulk_ip_security_info ...'
+      end
+      # verify the required parameter 'get_bulk_ip_geolocation_request' is set
+      if @api_client.config.client_side_validation && (!opts[:ips].is_a?(Array) || opts[:ips].empty?)
+        fail ArgumentError, "Missing the required parameter 'ips' (non-empty Array) when calling IPSecurityApi.get_bulk_ip_security_info"
+      end
+      allowable_values = ["en", "de", "ru", "ja", "fr", "cn", "es", "cs", "it", "ko", "fa", "pt"]
+      if @api_client.config.client_side_validation && opts[:'lang'] && !allowable_values.include?(opts[:'lang'])
+        fail ArgumentError, "invalid value for \"lang\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/security-bulk'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+      query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
+      query_params[:'excludes'] = opts[:'excludes'] if !opts[:'excludes'].nil?
+      query_params[:'output'] = opts[:'output'] if !opts[:'output'].nil?
+      query_params[:'lang'] = opts[:'lang'] if !opts[:'lang'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body({ ips: opts[:ips] })
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<BulkIPSecurity>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SecurityApi.get_bulk_ip_security_info",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: IPSecurityApi#get_bulk_ip_security_info\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # IP Security API provides security details of a given IP. It detects whether the IP is proxy, tor or bot. It also shows the proxy types of the IP (like VPN, PROXY, RELAY etc.) with it's VPN/proxy service provider making our API powerful VPN checker. It finds the IPs that are involved in spam activities. It also checks whether the IP links to a cloud provider and includes the provider's name.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ip query parameter &#39;ip&#39;. If not provided, will be your network IP
+    # @option opts [String] :include Include optional details like location and/or network.
+    # @option opts [String] :fields Get specific fields, objects from the response.
+    # @option opts [String] :excludes Exclude specific fields, objects from the response.
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter &#x60;lang&#x60;. Multi language feature is available only for &#x60;paid users&#x60;.
+    # @return [SecurityAPIResponse]
+    def get_ip_security_info(opts = {})
+      data, _status_code, _headers = get_ip_security_info_with_http_info(opts)
+      data
+    end
+
+    # IP Security API provides security details of a given IP. It detects whether the IP is proxy, tor or bot. It also shows the proxy types of the IP (like VPN, PROXY, RELAY etc.) with it&#39;s VPN/proxy service provider making our API powerful VPN checker. It finds the IPs that are involved in spam activities. It also checks whether the IP links to a cloud provider and includes the provider&#39;s name.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :ip query parameter &#39;ip&#39;. If not provided, will be your network IP
+    # @option opts [String] :include Include optional details like location and/or network.
+    # @option opts [String] :fields Get specific fields, objects from the response.
+    # @option opts [String] :excludes Exclude specific fields, objects from the response.
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter &#x60;lang&#x60;. Multi language feature is available only for &#x60;paid users&#x60;.
+    # @return [Array<(SecurityAPIResponse, Integer, Hash)>] SecurityAPIResponse data, response status code and response headers
+    def get_ip_security_info_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: IPSecurityApi.get_ip_security_info ...'
+      end
+      allowable_values = ["en", "de", "ru", "ja", "fr", "cn", "es", "cs", "it", "ko", "fa", "pt"]
+      if @api_client.config.client_side_validation && opts[:'lang'] && !allowable_values.include?(opts[:'lang'])
+        fail ArgumentError, "invalid value for \"lang\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/security'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ip'] = opts[:'ip'] if !opts[:'ip'].nil?
+      query_params[:'include'] = opts[:'include'] if !opts[:'include'].nil?
+      query_params[:'fields'] = opts[:'fields'] if !opts[:'fields'].nil?
+      query_params[:'excludes'] = opts[:'excludes'] if !opts[:'excludes'].nil?
+      query_params[:'output'] = opts[:'output'] if !opts[:'output'].nil?
+      query_params[:'lang'] = opts[:'lang'] if !opts[:'lang'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'SecurityAPIResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"SecurityApi.get_ip_security_info",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: IPSecurityApi#get_ip_security_info\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/ipgeolocation_sdk/api/time_conversion_api.rb

@@ -0,0 +1,122 @@
+=begin
+#IPGeolocation.io - IP intelligence products
+
+#Ipgeolocation provides a set of APIs to make ip based decisions.
+
+The version of the OpenAPI document: 2.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.13.0
+
+=end
+
+require 'cgi'
+
+module IpgeolocationSdk
+  class TimeConversionApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # You can convert a timestamp provided as a query paramter time from one time zone to another time zone.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :time time parameter takes the input in the following two formats: i) 'yyyy-MM-dd HH:mm', and ii) 'yyyy-MM-dd HH:mm:ss'. This parameter is optional and you can omit it to convert the current time between two coordinates, time zones or locations.
+    # @option opts [String] :tz_from timezone to convert from
+    # @option opts [String] :tz_to timezone to convert to
+    # @option opts [Float] :lat_from latitude to convert from
+    # @option opts [Float] :long_from longitude to convert from
+    # @option opts [Float] :lat_to latitude to convert to
+    # @option opts [Float] :long_to longitude to convert to
+    # @option opts [String] :location_from location to convert from
+    # @option opts [String] :location_to location to convert to
+    # @option opts [String] :icao_from location to convert from
+    # @option opts [String] :icao_to location to convert to
+    # @option opts [String] :iata_from location to convert from
+    # @option opts [String] :iata_to location to convert to
+    # @option opts [String] :locode_from location to convert from
+    # @option opts [String] :locode_to location to convert to
+    # @return [TimeConversionResponse]
+    def convert_time_between_timezones(opts = {})
+      data, _status_code, _headers = convert_time_between_timezones_with_http_info(opts)
+      data
+    end
+
+    # You can convert a timestamp provided as a query paramter time from one time zone to another time zone.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :time time parameter takes the input in the following two formats: i) 'yyyy-MM-dd HH:mm', and ii) 'yyyy-MM-dd HH:mm:ss'. This parameter is optional and you can omit it to convert the current time between two coordinates, time zones or locations.
+    # @option opts [String] :tz_from timezone to convert from
+    # @option opts [String] :tz_to timezone to convert to
+    # @option opts [Float] :lat_from latitude to convert from
+    # @option opts [Float] :long_from longitude to convert from
+    # @option opts [Float] :lat_to latitude to convert to
+    # @option opts [Float] :long_to longitude to convert to
+    # @option opts [String] :location_from location to convert from
+    # @option opts [String] :location_to location to convert to
+    # @option opts [String] :icao_from location to convert from
+    # @option opts [String] :icao_to location to convert to
+    # @option opts [String] :iata_from location to convert from
+    # @option opts [String] :iata_to location to convert to
+    # @option opts [String] :locode_from location to convert from
+    # @option opts [String] :locode_to location to convert to
+    # @return [Array<(TimeConversionResponse, Integer, Hash)>] TimeConversionResponse data, response status code and response headers
+    def convert_time_between_timezones_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TimeConversionApi.convert_time_between_timezones ...'
+      end
+      # resource path
+      local_var_path = '/timezone/convert'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'time'] = opts[:'time'] if !opts[:'time'].nil?
+      query_params[:'tz_from'] = opts[:'tz_from'] if !opts[:'tz_from'].nil?
+      query_params[:'tz_to'] = opts[:'tz_to'] if !opts[:'tz_to'].nil?
+      query_params[:'lat_from'] = opts[:'lat_from'] if !opts[:'lat_from'].nil?
+      query_params[:'long_from'] = opts[:'long_from'] if !opts[:'long_from'].nil?
+      query_params[:'lat_to'] = opts[:'lat_to'] if !opts[:'lat_to'].nil?
+      query_params[:'long_to'] = opts[:'long_to'] if !opts[:'long_to'].nil?
+      query_params[:'location_from'] = opts[:'location_from'] if !opts[:'location_from'].nil?
+      query_params[:'location_to'] = opts[:'location_to'] if !opts[:'location_to'].nil?
+      query_params[:'icao_from'] = opts[:'icao_from'] if !opts[:'icao_from'].nil?
+      query_params[:'icao_to'] = opts[:'icao_to'] if !opts[:'icao_to'].nil?
+      query_params[:'iata_from'] = opts[:'iata_from'] if !opts[:'iata_from'].nil?
+      query_params[:'iata_to'] = opts[:'iata_to'] if !opts[:'iata_to'].nil?
+      query_params[:'locode_from'] = opts[:'locode_from'] if !opts[:'locode_from'].nil?
+      query_params[:'locode_to'] = opts[:'locode_to'] if !opts[:'locode_to'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TimeConversionResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"TimeConversionApi.convert_time_between_timezones",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TimeConversionApi#convert_time_between_timezones\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/ipgeolocation_sdk/api/timezone_api.rb

@@ -0,0 +1,113 @@
+=begin
+#IPGeolocation.io - IP intelligence products
+
+#Ipgeolocation provides a set of APIs to make ip based decisions.
+
+The version of the OpenAPI document: 2.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.13.0
+
+=end
+
+require 'cgi'
+
+module IpgeolocationSdk
+  class TimezoneApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Timezone information details
+    # The Time Zone API provides current time, date, and time zone-related information. It supports various input types including time zone name, geographic coordinates, addresses, IPs, and location codes.  The API determines the time zone based on the following priority order if multiple parameters are provided:   1. Time Zone Name   2. Geographic Coordinates (latitude & longitude)   3. Location Address   4. IP Address   5. IATA Code   6. ICAO Code   7. UN/LOCODE  Enriched response data is returned based on the type of input: - IP: includes geolocation info - Address: includes location metadata - IATA/ICAO: includes airport info - UN/LOCODE: includes city details  You can call the time zone API without passing any time zone, coordinates, IATA, ICAO, LO code or IP address as well. It will use the calling machine's IP address to return the regional time zone information. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :tz pass a valid time zone name as a query parameter tz to get the time zone information.
+    # @option opts [String] :location pass any address of a location as the query parameter location to get the time zone information.
+    # @option opts [Float] :lat pass the latitude of a location as query parameters to get the time zone information.
+    # @option opts [Float] :long pass the longitude of a location as query parameters to get the time zone information.
+    # @option opts [String] :ip You can pass any IPv4 or IPv6 address as a query parameter ip to get the regional timezone information.
+    # @option opts [String] :iata_code pass any 3 letter IATA code as a query paramter iata_code to get the comprehensive airport details along with the time zone information, in which that airport exists.
+    # @option opts [String] :icao_code pass any 4 letter ICAO code as a query paramter icao_code to get the comprehensive airport details along with the time zone information, in which that airport exists.
+    # @option opts [String] :lo_code pass any 5 letter UNLOCODE as a query paramter lo_code to get the comprehensive lo code/city details along with the time zone information of the concerned city.
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter `lang`. Multi language feature is available only for `paid users`.
+    # @return [TimeZoneDetailedResponse]
+    def get_timezone_info(opts = {})
+      data, _status_code, _headers = get_timezone_info_with_http_info(opts)
+      data
+    end
+
+    # Timezone information details
+    # The Time Zone API provides current time, date, and time zone-related information. It supports various input types including time zone name, geographic coordinates, addresses, IPs, and location codes.  The API determines the time zone based on the following priority order if multiple parameters are provided:   1. Time Zone Name   2. Geographic Coordinates (latitude & longitude)   3. Location Address   4. IP Address   5. IATA Code   6. ICAO Code   7. UN/LOCODE  Enriched response data is returned based on the type of input: - IP: includes geolocation info - Address: includes location metadata - IATA/ICAO: includes airport info - UN/LOCODE: includes city details  You can call the time zone API without passing any time zone, coordinates, IATA, ICAO, LO code or IP address as well. It will use the calling machine's IP address to return the regional time zone information. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :tz pass a valid time zone name as a query parameter tz to get the time zone information.
+    # @option opts [String] :location pass any address of a location as the query parameter location to get the time zone information.
+    # @option opts [Float] :lat pass the latitude of a location as query parameters to get the time zone information.
+    # @option opts [Float] :long pass the longitude of a location as query parameters to get the time zone information.
+    # @option opts [String] :ip You can pass any IPv4 or IPv6 address as a query parameter ip to get the regional timezone information.
+    # @option opts [String] :iata_code pass any 3 letter IATA code as a query paramter iata_code to get the comprehensive airport details along with the time zone information, in which that airport exists.
+    # @option opts [String] :icao_code pass any 4 letter ICAO code as a query paramter icao_code to get the comprehensive airport details along with the time zone information, in which that airport exists.
+    # @option opts [String] :lo_code pass any 5 letter UNLOCODE as a query paramter lo_code to get the comprehensive lo code/city details along with the time zone information of the concerned city.
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [String] :lang By default, the API responds in English. You can change the response language by passing the language code as a query parameter `lang`. Multi language feature is available only for `paid users`.
+    # @return [Array<(TimeZoneDetailedResponse, Integer, Hash)>] TimeZoneDetailedResponse data, response status code and response headers
+    def get_timezone_info_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TimezoneApi.get_timezone_info ...'
+      end
+      allowable_values = ["en", "de", "ru", "ja", "fr", "cn", "es", "cs", "it", "ko", "fa", "pt"]
+      if @api_client.config.client_side_validation && opts[:'lang'] && !allowable_values.include?(opts[:'lang'])
+        fail ArgumentError, "invalid value for \"lang\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/timezone'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'tz'] = opts[:'tz'] if !opts[:'tz'].nil?
+      query_params[:'location'] = opts[:'location'] if !opts[:'location'].nil?
+      query_params[:'lat'] = opts[:'lat'] if !opts[:'lat'].nil?
+      query_params[:'long'] = opts[:'long'] if !opts[:'long'].nil?
+      query_params[:'ip'] = opts[:'ip'] if !opts[:'ip'].nil?
+      query_params[:'iata_code'] = opts[:'iata_code'] if !opts[:'iata_code'].nil?
+      query_params[:'icao_code'] = opts[:'icao_code'] if !opts[:'icao_code'].nil?
+      query_params[:'lo_code'] = opts[:'lo_code'] if !opts[:'lo_code'].nil?
+      query_params[:'output'] = opts[:'output'] if !opts[:'output'].nil?
+      query_params[:'lang'] = opts[:'lang'] if !opts[:'lang'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'TimeZoneResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"TimezoneApi.get_timezone_info",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TimezoneApi#get_timezone_info\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/ipgeolocation_sdk/api/user_agent_api.rb

@@ -0,0 +1,158 @@
+=begin
+#IPGeolocation.io - IP intelligence products
+
+#Ipgeolocation provides a set of APIs to make ip based decisions.
+
+The version of the OpenAPI document: 2.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.13.0
+
+=end
+
+require 'cgi'
+
+module IpgeolocationSdk
+  class UserAgentApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get details of user-agent
+    # User Agent Parser API provides the accurate browser, device, and operating system details from a User Agent String. It also provides information about crawlers and attack sources. You can use these details to customize user experience, prevent crawlers and attackers from accessing your website. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :user_agent 
+    # @option opts [String] :output Desired output format (json or xml).
+    # @return [UserAgentData]
+    def get_user_agent_details(opts = {})
+      data, _status_code, _headers = get_user_agent_details_with_http_info(opts)
+      data
+    end
+
+    # Get details of user-agent
+    # User Agent Parser API provides the accurate browser, device, and operating system details from a User Agent String. It also provides information about crawlers and attack sources. You can use these details to customize user experience, prevent crawlers and attackers from accessing your website. 
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :user_agent 
+    # @option opts [String] :output Desired output format (json or xml).
+    # @return [Array<(UserAgentData, Integer, Hash)>] UserAgentData data, response status code and response headers
+    def get_user_agent_details_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UserAgentApi.get_user_agent_details ...'
+      end
+      # resource path
+      local_var_path = '/user-agent'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'output'] = opts[:'output'] if !opts[:'output'].nil?
+      # query_params[:'userAgent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+      header_params[:'User-Agent'] = opts[:'user_agent'] if !opts[:'user_agent'].nil?
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'UserAgentData'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"UserAgentApi.get_user_agent_details",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: UserAgentApi#get_user_agent_details\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Handle multiple user-agent string lookups
+    # This endpoint allows you to perform the parsing of multiple User-Angent strings (max. 50,000) at the same time. The requests count per round is equal to total User-Agent strings passed. This feature is `only available for paid plans`.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [ParseBulkUserAgentStringsRequest] :parse_bulk_user_agent_strings_request 
+    # @return [Array<UserAgentData>]
+    def parse_bulk_user_agent_strings(opts = {})
+      data, _status_code, _headers = parse_bulk_user_agent_strings_with_http_info(opts)
+      data
+    end
+
+    # Handle multiple user-agent string lookups
+    # This endpoint allows you to perform the parsing of multiple User-Angent strings (max. 50,000) at the same time. The requests count per round is equal to total User-Agent strings passed. This feature is &#x60;only available for paid plans&#x60;.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :output Desired output format (json or xml).
+    # @option opts [ParseBulkUserAgentStringsRequest] :parse_bulk_user_agent_strings_request 
+    # @return [Array<(Array<UserAgentData>, Integer, Hash)>] Array<UserAgentData> data, response status code and response headers
+    def parse_bulk_user_agent_strings_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: UserAgentApi.parse_bulk_user_agent_strings ...'
+      end
+      # Verify the required parameter 'user_agents' in opts is set 
+      if @api_client.config.client_side_validation && (!opts[:user_agents].is_a?(Array) || opts[:user_agents].empty?)
+        fail ArgumentError, "Missing the required parameter 'user_agents' (non-empty Array) when calling UserAgentApi.parse_bulk_user_agent_strings"
+      end
+      # resource path
+      local_var_path = '/user-agent-bulk'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'output'] = opts[:'output'] if !opts[:'output'].nil?
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json', 'application/xml']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body({
+        uaStrings: opts[:user_agents]
+      })
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Array<UserAgentData>'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ApiKeyAuth']
+
+      new_options = opts.merge(
+        :operation => :"UserAgentApi.parse_bulk_user_agent_strings",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: UserAgentApi#parse_bulk_user_agent_strings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end