Module: Uirusu::VTUrl

Defined in:
lib/uirusu/vturl.rb

Constant Summary collapse

SCAN_URL = 
Uirusu::VT_API + "/url/scan"
REPORT_URL = 
Uirusu::VT_API + "/url/report"

Class Method Summary collapse

Class Method Details

.query_report(api_key, resource) ⇒ JSON

Searches reports by URL from Virustotal.com

Parameters:

  • api_key —

    Virustotal.com API key

  • resource —

    url to search

Returns:

  • (JSON) —

    Parsed response



71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/uirusu/vturl.rb', line 71

def self.query_report(api_key, resource)
	if api_key == nil
		raise "Invalid API Key"
	end

	if resource == nil
		raise "Invalid resource, must be a valid url"
	end

	response = RestClient.post REPORT_URL, :apikey => api_key, :resource => resource

	case response.code
		when 429
			raise "Virustotal limit reached. Try again later."
		when 403
			raise "Invalid privileges, please check your API key."
		when 200
			JSON.parse(response)
		else
			raise "Unknown Server error."
	end
end

.scan_url(api_key, resource) ⇒ JSON

Submits a URL to be scanned by Virustotal.com

Parameters:

  • api_key —

    Virustotal.com API key

  • resource —

    url to submit

Returns:

  • (JSON) —

    Parsed response



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/uirusu/vturl.rb', line 42

def self.scan_url(api_key, resource)
	if api_key == nil
		raise "Invalid API Key"
	end

	if resource == nil
		raise "Invalid resource, must be a valid url"
	end

	response = RestClient.post SCAN_URL, :apikey => api_key, :url => resource

	case response.code
		when 429
			raise "Virustotal limit reached. Try again later."
		when 403
			raise "Invalid privileges, please check your API key."
		when 200
			JSON.parse(response)
		else
			raise "Unknown Server error."
	end
end