vt3 0.7.3

VirusTotal REST API v3 (Public & Enterprise)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

mod response;
use response::{Root, ScanRoot};

use crate::{
    utils::{http_get, http_post},
    VtClient, VtResult,
};
use base64::{engine::general_purpose::STANDARD, Engine as _};

impl VtClient {
    pub fn url_scan(&self, resource_url: &str) -> VtResult<ScanRoot> {
        //! Scan an URL
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let url = "https://example.com";
        //! println!("{:?}", vt.url_scan(url));
        //! ```
        let url = format!("{}/urls", &self.endpoint);
        let form_data = &[("public_api.url", resource_url)];
        http_post(&self.api_key, &self.user_agent, &url, form_data)
    }

    pub fn url_rescan(&self, resource_id: &str) -> VtResult<ScanRoot> {
        //! Re-analyse/Re-Scan an URL
        //!
        //! ## Example Usage
        //!
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let url = "https://example.com";
        //! println!("{:?}", vt.url_scan(url));
        //! ```
        let url_id = resource_id.split('-').nth(1).unwrap_or(resource_id);
        let url = format!("{}/urls/{}/analyse", &self.endpoint, url_id);
        let form_data = &[("public_api.url", resource_id)];
        http_post(&self.api_key, &self.user_agent, &url, form_data)
    }

    pub fn url_info(&self, resource_url: &str) -> VtResult<Root> {
        //! Get the report of a given Url
        //!
        //! ## Example Usage
        //!
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let resource = "https://www.example.com";
        //! println!("{:?}", vt.url_info(resource));
        //! ```
        let url = format!(
            "{}/urls/{}",
            &self.endpoint,
            STANDARD.encode(resource_url).replace('=', "")
        );
        http_get(&self.api_key, &self.user_agent, &url)
    }

    pub fn url_info_by_id(&self, resource_id: &str) -> VtResult<Root> {
        //! Get the report of a given Url by its resource id. Generally you can first
        //! submit a public_api.url for scanning, and then, get the resource_id (`data.id`)
        //! and then url_info_by_id(data.id)
        //!
        //! ## Example Usage
        //!
        //! ```ignore
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let resource = "https://www.example.com";
        //! let resource_id = vt.url_scan(resource).unwrap();
        //! println!("{:?}", vt.url_info_by_id(&resource_id.data.id))
        //! ```
        let url_id = resource_id.split('-').nth(1).unwrap_or(resource_id);
        let url = format!("{}/urls/{}", &self.endpoint, url_id);
        http_get(&self.api_key, &self.user_agent, &url)
    }
}