Contents

# frozen_string_literal: true

require "base64"

module VirusTotal
  module Client
    class URL < Base
      include Action::Comments
      include Action::Get
      include Action::Relationships
      include Action::Votes

      #
      # Analyse an URL.
      #
      # @see https://developers.virustotal.com/v3.0/reference#urls-analyse
      #
      # @param [String] url URL identifier
      #
      # @return [Hash]
      #
      def analyse(url)
        id = to_id(url)
        _post("/urls/#{id}/analyse") { |json| json }
      end

      #
      # Domain or IP address for a URL.
      #
      # @see https://developers.virustotal.com/v3.0/reference#urlsidnetwork_location
      #
      # @param [String] url URL identifier
      #
      # @return [Hash]
      #
      def network_location(url)
        id = to_id(url)
        _get("/urls/#{id}/network_location") { |json| json }
      end

      private

      def to_id(url)
        Base64.urlsafe_encode64(url).split("=").first
      end

      def relationships
        @relationships ||= %w[
          analyses
          downloaded_files
          graphs
          last_serving_ip_address
          redirecting_urls
          submissions
        ].map(&:to_sym)
      end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
virustotalx-1.2.0	lib/virustotal/clients/url.rb