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



63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
 
# File 'lib/uirusu/vturl.rb', line 63

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, 204
			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



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/uirusu/vturl.rb', line 34

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, 204
			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