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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

mod response;
use response::SearchRulesetRoot;
pub use response::SubmitLivehuntRuleset;

use crate::{
    utils::{http_body_post, http_delete, http_get, http_get_with_params, http_patch},
    VtClient, VtResult,
};

impl VtClient {
    pub fn get_rulesets(
        &self,
        limit: Option<&str>,
        order: Option<&str>,
        filter: Option<&str>,
        cursor: Option<&str>,
    ) -> VtResult<SearchRulesetRoot> {
        //! Retrieve VT Hunting livehunt rulesets
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! vt.get_rulesets(Some("10"), None, None, None);
        //! ```
        let url = format!("{}/intelligence/hunting_rulesets", self.endpoint);
        let mut query_params: Vec<(&str, &str)> = Vec::new();
        if let Some(l) = limit {
            query_params.push(("limit", l))
        }
        if let Some(o) = order {
            query_params.push(("order", o))
        }
        if let Some(f) = filter {
            query_params.push(("filter", f))
        }
        if let Some(c) = cursor {
            query_params.push(("cursor", c))
        }

        http_get_with_params(
            &self.api_key,
            &self.user_agent,
            &url,
            &query_params.as_slice(),
        )
    }

    pub fn get_ruleset(&self, ruleset_id: &str) -> VtResult<SearchRulesetRoot> {
        //! Retrieve a VT Hunting Livehunt ruleset given by a id
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! vt.get_ruleset("1");
        //! ```
        let url = format!(
            "{}/intelligence/hunting_rulesets/{}",
            self.endpoint, ruleset_id
        );
        http_get(&self.api_key, &self.user_agent, &url)
    }

    pub fn create_ruleset(&self, data: &SubmitLivehuntRuleset) -> VtResult<SubmitLivehuntRuleset> {
        //! Create/Submit a new VT Hunting Livehunt ruleset
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::{VtClient, SubmitLivehuntRuleset};
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let mut data = SubmitLivehuntRuleset::default();
        //! vt.create_ruleset(&data);
        //! ```
        let url = format!("{}/intelligence/hunting_rulesets", self.endpoint);
        http_body_post(&self.api_key, &self.user_agent, &url, data)
    }

    pub fn delete_ruleset(&self, ruleset_id: &str) -> VtResult<String> {
        //! Delete/Remove Hunting ruleset by ID
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::VtClient;
        //!
        //! let vt = VtClient::new("Your API Key");
        //! vt.delete_ruleset("1");
        //! ```
        let url = format!(
            "{}/intelligence/hunting_rulesets/{}",
            self.endpoint, ruleset_id
        );
        http_delete(&self.api_key, &self.user_agent, &url)
    }

    pub fn update_ruleset(
        &self,
        ruleset_id: &str,
        data: &SubmitLivehuntRuleset,
    ) -> VtResult<SubmitLivehuntRuleset> {
        //! Update/Modify a VT Hunting Livehunt ruleset
        //!
        //! ## Example Usage
        //! ```rust
        //! use vt3::{VtClient, SubmitLivehuntRuleset};
        //!
        //! let vt = VtClient::new("Your API Key");
        //! let mut data = SubmitLivehuntRuleset::default();
        //! vt.update_ruleset("1", &data);
        //! ```
        let url = format!(
            "{}/intelligence/hunting_rulesets/{}",
            self.endpoint, ruleset_id
        );
        http_patch(&self.api_key, &self.user_agent, &url, data)
    }
}