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
121
122
123
124
125
126
127
128
|
/*
Copyright 2014 VirusTotal S.L. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
#ifndef VT_URL_DIST
#define VT_URL_DIST 1
#ifdef __cplusplus
extern "C" {
#endif
// forward declarations
struct VtUrlDist;
struct VtResponse;
typedef void (VtUrlDistCb)(const char *url, unsigned long long timestamp, int total, int positives, json_t *raw_json, void *data);
/**
* @ingroup VtApiPage
* @defgroup VtUrlDist VtUrlDist URL Distribution service. Requires private-API with permissions
* @{
*/
struct VtUrlDist* VtUrlDist_new(void);
/** Get a reference counter */
void VtUrlDist_get(struct VtUrlDist *FileScan);
/** put a reference counter */
void VtUrlDist_put(struct VtUrlDist **FileScan);
/**
* @brief ...
*
* @param vt_udist ...
* @param api_key ...
* @return void
*/
void VtUrlDist_setApiKey(struct VtUrlDist *vt_udist, const char *api_key);
/**
* @brief set all info flag
*
* @param vt_udist ...
* @param value true/false
* @return void
*/
void VtUrlDist_setAllInfo(struct VtUrlDist *vt_udist, bool value);
/**
* @brief set after time
*
* @param vt_udist VtUrlDist ojbect pointer
* @param value time sinc epoch in miliseconds
* @return void
*/
void VtUrlDist_setAfter(struct VtUrlDist *vt_udist, unsigned long long value);
/**
* @brief set the before time paramater
*
* @param vt_udist ...
* @param value time since epoch in miniseconds
* @return void
*/
void VtUrlDist_setBefore(struct VtUrlDist *vt_udist, unsigned long long value);
/**
* @brief set limit of results
*
* @param vt_udist VtUrlDist ojbect pointer
* @param value ...
* @return void
*/
void VtUrlDist_setLimit(struct VtUrlDist *vt_udist, int value);
struct VtResponse * VtUrlDist_getResponse(struct VtUrlDist *vt_udist);
/**
* @brief Get the distribution feed.
*
* @param vt_udist ...
* @return int
*/
int VtUrlDist_getDistribution(struct VtUrlDist *vt_udist);
/**
* @brief parse the URL dist results and for each results call the callback function.
*
* @param url_dist VtUrlDist object
* @param VtUrlDistCb URL distribution callback function pointer
* @param user_data user data to be passed to callback
* @return int
*/
int VtUrlDist_parse(struct VtUrlDist* url_dist, VtUrlDistCb, void *user_data);
/**
* @brief wraper to combind VtUrlDist_getResponse() and VtUrlDist_parse()
*
* @param VtUrlDist callback
* @param VtUrlDistCb callback function pointer
* @param user_data user data to be passed to callback
* @return int
*/
int VtUrlDist_process(struct VtUrlDist* url_dist, VtUrlDistCb, void *user_data);
/**
* @}
*/
#ifdef __cplusplus
}
#endif /*cplusplus*/
#endif
|
