apifreaks 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c022d7049fc7c4f1c67188c17d82573b8df89f836bfe1ec26055ce9970c5f4b6
-  data.tar.gz: ba53b7d5c019c3ddd3c022ba91f677ed5b400222bd89e57577d88f11d35fc6ed
+  metadata.gz: 32a9d6da3816e2830785311c2f784b7852bd1c0fbceaf4d316cb677adc5d0c71
+  data.tar.gz: 3eaf9e81c889241b65bc6d7f42237bc59dabd1d48d0d3e5080db015eec109243
 SHA512:
-  metadata.gz: 8dbace455253a45ca007ed39a15bf9d820aa4ec8c7af2b4102726d31e75ff2aa09a500fc0541c039163aff5a3b1990a80078f3d9f2834a894b2846134dfd03c8
-  data.tar.gz: 4eca80c3c150f77773bd15532a8bab7849e355f7241e1647567775d56fe0f0572cc0b363834a4a6e366f088958c7e71892af60d2c0c4886ae7261070d1922156
+  metadata.gz: f4d6c4bd6f0720106c69b6e047ee116cc780e9d676e9720ea3d9b731607144707f1a74ca3643ac4c6127962bd55d72810ce4dd0ef2ec89bbe96aecb684640379
+  data.tar.gz: ebd9dacecf79c2c401d3cbc8feee725f2aa3ccdc1006f4f2cf19777c11f1e9995523e9eef2235c13ed53196a78ac2ea40c2a47a4ac42abb5270769a42a775044

data/lib/apifreaks/client.rb

@@ -53,6 +53,57 @@ module Apifreaks
       end
     end
 
+    # Get detailed geolocation data for an IP address (v2.0) including country, city, timezone, currency, and optional
+    # security and user-agent information
+    #
+    # @param request_options [Hash]
+    # @param params [Hash]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::GeolocationLookupRequestFormat, nil] :format
+    # @option params [String, nil] :ip
+    # @option params [Apifreaks::Types::GeolocationLookupRequestLang, nil] :lang
+    # @option params [String, nil] :fields
+    # @option params [String, nil] :excludes
+    # @option params [String, nil] :include
+    #
+    # @return [Apifreaks::Types::GeolocationLookupResponse]
+    def geolocation_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+      query_params["ip"] = params[:ip] if params.key?(:ip)
+      query_params["lang"] = params[:lang] if params.key?(:lang)
+      query_params["fields"] = params[:fields] if params.key?(:fields)
+      query_params["excludes"] = params[:excludes] if params.key?(:excludes)
+      query_params["include"] = params[:include] if params.key?(:include)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "GET",
+        path: "v2.0/geolocation/lookup",
+        query: query_params,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::GeolocationLookupResponse.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # Retrieve detailed geolocation data for multiple IP addresses in a single request.
     # Supports up to `50,000` IP-addresses/host-names per request.
     #
@@ -107,6 +158,60 @@ module Apifreaks
       end
     end
 
+    # Retrieve detailed geolocation data for multiple IP addresses in a single request (v2.0).
+    # Supports up to `50,000` IP-addresses/host-names per request.
+    #
+    # @param request_options [Hash]
+    # @param params [Apifreaks::Types::BulkGeolocationLookupRequest]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::BulkGeolocationLookupRequestFormat, nil] :format
+    # @option params [String, nil] :lang
+    # @option params [String, nil] :fields
+    # @option params [String, nil] :excludes
+    # @option params [String, nil] :include
+    #
+    # @return [Array[Apifreaks::Types::BulkGeolocationLookupResponseItem]]
+    def bulk_geolocation_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      request_data = Apifreaks::Types::BulkGeolocationLookupRequest.new(params).to_h
+      non_body_param_names = %w[apiKey format lang fields excludes include]
+      body = request_data.except(*non_body_param_names)
+
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+      query_params["lang"] = params[:lang] if params.key?(:lang)
+      query_params["fields"] = params[:fields] if params.key?(:fields)
+      query_params["excludes"] = params[:excludes] if params.key?(:excludes)
+      query_params["include"] = params[:include] if params.key?(:include)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "POST",
+        path: "v2.0/geolocation/lookup",
+        query: query_params,
+        body: body,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::BulkGeolocationLookupResponseItem.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # Get comprehensive security information for a given IP address. Detects VPNs, proxies, Tor nodes, and other
     # security threats.
     #
@@ -354,6 +459,49 @@ module Apifreaks
       end
     end
 
+    # Retrieve live WHOIS information for a single domain name (v2.0), including registration
+    # dates, nameservers, and registrant information.
+    #
+    # @param request_options [Hash]
+    # @param params [Hash]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::DomainWhoisLookupRequestFormat, nil] :format
+    # @option params [String] :domain_name
+    #
+    # @return [Apifreaks::Types::DomainWhoisLookupResponse]
+    def domain_whois_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+      query_params["domainName"] = params[:domain_name] if params.key?(:domain_name)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "GET",
+        path: "v2.0/domain/whois/live",
+        query: query_params,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::DomainWhoisLookupResponse.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # Retrieve WHOIS information for `100 Domains per Request`.
     #
     # @param request_options [Hash]
@@ -399,6 +547,51 @@ module Apifreaks
       end
     end
 
+    # Retrieve WHOIS information for `100 Domains per Request` (v2.0).
+    #
+    # @param request_options [Hash]
+    # @param params [Apifreaks::Types::BulkDomainWhoisLookupRequest]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::BulkDomainWhoisLookupRequestFormat, nil] :format
+    #
+    # @return [Apifreaks::Types::BulkDomainWhoisLookupResponse]
+    def bulk_domain_whois_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      request_data = Apifreaks::Types::BulkDomainWhoisLookupRequest.new(params).to_h
+      non_body_param_names = %w[apiKey format]
+      body = request_data.except(*non_body_param_names)
+
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "POST",
+        path: "v2.0/domain/whois/live",
+        query: query_params,
+        body: body,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::BulkDomainWhoisLookupResponse.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # Returns WHOIS registration details for a specified IP address (IPv4 or IPv6).
     #
     # @param request_options [Hash]
@@ -4871,6 +5064,65 @@ module Apifreaks
       end
     end
 
+    # Retrieve current time, date, and timezone-related information (v2.0) by specifying a timezone name, location
+    # address, location coordinates, IP address, or use the client IP address if no parameter is passed.
+    #
+    # @param request_options [Hash]
+    # @param params [Hash]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::TimezoneLookupRequestFormat, nil] :format
+    # @option params [String, nil] :ip
+    # @option params [String, nil] :tz
+    # @option params [String, nil] :location
+    # @option params [Integer, nil] :lat
+    # @option params [Integer, nil] :long
+    # @option params [Apifreaks::Types::TimezoneLookupRequestLang, nil] :lang
+    # @option params [String, nil] :iata_code
+    # @option params [String, nil] :icao_code
+    # @option params [String, nil] :lo_code
+    #
+    # @return [Apifreaks::Types::TimezoneLookupResponse]
+    def timezone_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+      query_params["ip"] = params[:ip] if params.key?(:ip)
+      query_params["tz"] = params[:tz] if params.key?(:tz)
+      query_params["location"] = params[:location] if params.key?(:location)
+      query_params["lat"] = params[:lat] if params.key?(:lat)
+      query_params["long"] = params[:long] if params.key?(:long)
+      query_params["lang"] = params[:lang] if params.key?(:lang)
+      query_params["iata_code"] = params[:iata_code] if params.key?(:iata_code)
+      query_params["icao_code"] = params[:icao_code] if params.key?(:icao_code)
+      query_params["lo_code"] = params[:lo_code] if params.key?(:lo_code)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "GET",
+        path: "v2.0/geolocation/timezone",
+        query: query_params,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::TimezoneLookupResponse.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # Converts a given time from one timezone to another using various input types like timezone name, coordinates,
     # location, or codes.
     #
@@ -5333,6 +5585,64 @@ module Apifreaks
       end
     end
 
+    # Retrieve sunrise and sunset times, current position of the moon, and other related information (v2.0) by
+    # specifying a location address, location coordinates, IP address, or using the client IP address if no parameter
+    # is passed.
+    #
+    # @param request_options [Hash]
+    # @param params [Hash]
+    # @option request_options [String] :base_url
+    # @option request_options [Hash{String => Object}] :additional_headers
+    # @option request_options [Hash{String => Object}] :additional_query_parameters
+    # @option request_options [Hash{String => Object}] :additional_body_parameters
+    # @option request_options [Integer] :timeout_in_seconds
+    # @option params [String] :api_key
+    # @option params [Apifreaks::Types::AstronomyLookupRequestFormat, nil] :format
+    # @option params [String, nil] :location
+    # @option params [Integer, nil] :lat
+    # @option params [Integer, nil] :long
+    # @option params [String, nil] :ip
+    # @option params [String, nil] :lang
+    # @option params [String, nil] :date
+    # @option params [Integer, nil] :elevation
+    # @option params [String, nil] :time_zone
+    #
+    # @return [Apifreaks::Types::AstronomyLookupResponse]
+    def astronomy_lookup_v2(request_options: {}, **params)
+      params = Apifreaks::Internal::Types::Utils.normalize_keys(params)
+      query_params = {}
+      query_params["apiKey"] = params[:api_key] if params.key?(:api_key)
+      query_params["format"] = params[:format] if params.key?(:format)
+      query_params["location"] = params[:location] if params.key?(:location)
+      query_params["lat"] = params[:lat] if params.key?(:lat)
+      query_params["long"] = params[:long] if params.key?(:long)
+      query_params["ip"] = params[:ip] if params.key?(:ip)
+      query_params["lang"] = params[:lang] if params.key?(:lang)
+      query_params["date"] = params[:date] if params.key?(:date)
+      query_params["elevation"] = params[:elevation] if params.key?(:elevation)
+      query_params["time_zone"] = params[:time_zone] if params.key?(:time_zone)
+
+      request = Apifreaks::Internal::JSON::Request.new(
+        base_url: request_options[:base_url],
+        method: "GET",
+        path: "v2.0/geolocation/astronomy",
+        query: query_params,
+        request_options: request_options
+      )
+      begin
+        response = @raw_client.send(request)
+      rescue Net::HTTPRequestTimeout
+        raise Apifreaks::Errors::TimeoutError
+      end
+      code = response.code.to_i
+      if code.between?(200, 299)
+        Apifreaks::Types::AstronomyLookupResponse.load(response.body)
+      else
+        error_class = Apifreaks::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+    end
+
     # @param base_url [String, nil]
     # @param max_retries [Integer]
     #

data/lib/apifreaks/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Apifreaks
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end