Coverage for fingerprint_pro_server_api_sdk/models/identification.py: 92%
203 statements
« prev ^ index » next coverage.py v7.10.1, created at 2025-07-30 17:13 +0000
« prev ^ index » next coverage.py v7.10.1, created at 2025-07-30 17:13 +0000
1# coding: utf-8
3"""
4 Fingerprint Server API
6 Fingerprint Server API allows you to search, update, and delete identification events in a server environment. It can be used for data exports, decision-making, and data analysis scenarios. Server API is intended for server-side usage, it's not intended to be used from the client side, whether it's a browser or a mobile device. # noqa: E501
8 OpenAPI spec version: 3
9 Contact: support@fingerprint.com
10 Generated by: https://github.com/swagger-api/swagger-codegen.git
11"""
13import re # noqa: F401
14from typing import Dict, List, Optional # noqa: F401
15from fingerprint_pro_server_api_sdk.base_model import BaseModel
16from fingerprint_pro_server_api_sdk.models.browser_details import BrowserDetails
17from fingerprint_pro_server_api_sdk.models.deprecated_geolocation import DeprecatedGeolocation
18from datetime import datetime
19from fingerprint_pro_server_api_sdk.models.tag import Tag
20from fingerprint_pro_server_api_sdk.models.identification_confidence import IdentificationConfidence
21from fingerprint_pro_server_api_sdk.models.identification_seen_at import IdentificationSeenAt
22from fingerprint_pro_server_api_sdk.models.identification_seen_at import IdentificationSeenAt
23from fingerprint_pro_server_api_sdk.models.raw_device_attributes import RawDeviceAttributes
24from fingerprint_pro_server_api_sdk.models.sdk import SDK
27class Identification(BaseModel):
28 """NOTE: This class is auto generated by the swagger code generator program.
30 Do not edit the class manually.
31 """
32 """
33 Attributes:
34 swagger_types (dict): The key is attribute name
35 and the value is attribute type.
36 attribute_map (dict): The key is attribute name
37 and the value is json key in definition.
38 """
39 swagger_types = {
40 'visitor_id': 'str',
41 'request_id': 'str',
42 'browser_details': 'BrowserDetails',
43 'incognito': 'bool',
44 'ip': 'str',
45 'ip_location': 'DeprecatedGeolocation',
46 'linked_id': 'str',
47 'suspect': 'bool',
48 'timestamp': 'int',
49 'time': 'datetime',
50 'url': 'str',
51 'tag': 'Tag',
52 'confidence': 'IdentificationConfidence',
53 'visitor_found': 'bool',
54 'first_seen_at': 'IdentificationSeenAt',
55 'last_seen_at': 'IdentificationSeenAt',
56 'components': 'RawDeviceAttributes',
57 'replayed': 'bool',
58 'sdk': 'SDK'
59 }
61 nullable_map = {
62 'visitor_id': False,
63 'request_id': False,
64 'browser_details': False,
65 'incognito': False,
66 'ip': False,
67 'ip_location': False,
68 'linked_id': False,
69 'suspect': False,
70 'timestamp': False,
71 'time': False,
72 'url': False,
73 'tag': False,
74 'confidence': False,
75 'visitor_found': False,
76 'first_seen_at': False,
77 'last_seen_at': False,
78 'components': False,
79 'replayed': False,
80 'sdk': False
81 }
83 attribute_map = {
84 'visitor_id': 'visitorId',
85 'request_id': 'requestId',
86 'browser_details': 'browserDetails',
87 'incognito': 'incognito',
88 'ip': 'ip',
89 'ip_location': 'ipLocation',
90 'linked_id': 'linkedId',
91 'suspect': 'suspect',
92 'timestamp': 'timestamp',
93 'time': 'time',
94 'url': 'url',
95 'tag': 'tag',
96 'confidence': 'confidence',
97 'visitor_found': 'visitorFound',
98 'first_seen_at': 'firstSeenAt',
99 'last_seen_at': 'lastSeenAt',
100 'components': 'components',
101 'replayed': 'replayed',
102 'sdk': 'sdk'
103 }
105 def __init__(self, visitor_id=None, request_id=None, browser_details=None, incognito=None, ip=None, ip_location=None, linked_id=None, suspect=None, timestamp=None, time=None, url=None, tag=None, confidence=None, visitor_found=None, first_seen_at=None, last_seen_at=None, components=None, replayed=None, sdk=None): # noqa: E501
106 """Identification - a model defined in Swagger""" # noqa: E501
107 self._visitor_id = None
108 self._request_id = None
109 self._browser_details = None
110 self._incognito = None
111 self._ip = None
112 self._ip_location = None
113 self._linked_id = None
114 self._suspect = None
115 self._timestamp = None
116 self._time = None
117 self._url = None
118 self._tag = None
119 self._confidence = None
120 self._visitor_found = None
121 self._first_seen_at = None
122 self._last_seen_at = None
123 self._components = None
124 self._replayed = None
125 self._sdk = None
126 self.discriminator = None
127 self.visitor_id = visitor_id
128 self.request_id = request_id
129 self.browser_details = browser_details
130 self.incognito = incognito
131 self.ip = ip
132 if ip_location is not None:
133 self.ip_location = ip_location
134 if linked_id is not None:
135 self.linked_id = linked_id
136 if suspect is not None:
137 self.suspect = suspect
138 self.timestamp = timestamp
139 self.time = time
140 self.url = url
141 self.tag = tag
142 if confidence is not None:
143 self.confidence = confidence
144 self.visitor_found = visitor_found
145 self.first_seen_at = first_seen_at
146 self.last_seen_at = last_seen_at
147 if components is not None:
148 self.components = components
149 self.replayed = replayed
150 if sdk is not None:
151 self.sdk = sdk
153 @property
154 def visitor_id(self) -> str:
155 """Gets the visitor_id of this Identification. # noqa: E501
157 String of 20 characters that uniquely identifies the visitor's browser. # noqa: E501
159 :return: The visitor_id of this Identification. # noqa: E501
160 """
161 return self._visitor_id
163 @visitor_id.setter
164 def visitor_id(self, visitor_id: str):
165 """Sets the visitor_id of this Identification.
167 String of 20 characters that uniquely identifies the visitor's browser. # noqa: E501
169 :param visitor_id: The visitor_id of this Identification. # noqa: E501
170 """
171 if visitor_id is None:
172 raise ValueError("Invalid value for `visitor_id`, must not be `None`") # noqa: E501
174 self._visitor_id = visitor_id
176 @property
177 def request_id(self) -> str:
178 """Gets the request_id of this Identification. # noqa: E501
180 Unique identifier of the user's request. # noqa: E501
182 :return: The request_id of this Identification. # noqa: E501
183 """
184 return self._request_id
186 @request_id.setter
187 def request_id(self, request_id: str):
188 """Sets the request_id of this Identification.
190 Unique identifier of the user's request. # noqa: E501
192 :param request_id: The request_id of this Identification. # noqa: E501
193 """
194 if request_id is None:
195 raise ValueError("Invalid value for `request_id`, must not be `None`") # noqa: E501
197 self._request_id = request_id
199 @property
200 def browser_details(self) -> BrowserDetails:
201 """Gets the browser_details of this Identification. # noqa: E501
204 :return: The browser_details of this Identification. # noqa: E501
205 """
206 return self._browser_details
208 @browser_details.setter
209 def browser_details(self, browser_details: BrowserDetails):
210 """Sets the browser_details of this Identification.
213 :param browser_details: The browser_details of this Identification. # noqa: E501
214 """
215 if browser_details is None:
216 raise ValueError("Invalid value for `browser_details`, must not be `None`") # noqa: E501
218 self._browser_details = browser_details
220 @property
221 def incognito(self) -> bool:
222 """Gets the incognito of this Identification. # noqa: E501
224 Flag if user used incognito session. # noqa: E501
226 :return: The incognito of this Identification. # noqa: E501
227 """
228 return self._incognito
230 @incognito.setter
231 def incognito(self, incognito: bool):
232 """Sets the incognito of this Identification.
234 Flag if user used incognito session. # noqa: E501
236 :param incognito: The incognito of this Identification. # noqa: E501
237 """
238 if incognito is None:
239 raise ValueError("Invalid value for `incognito`, must not be `None`") # noqa: E501
241 self._incognito = incognito
243 @property
244 def ip(self) -> str:
245 """Gets the ip of this Identification. # noqa: E501
247 IP address of the requesting browser or bot. # noqa: E501
249 :return: The ip of this Identification. # noqa: E501
250 """
251 return self._ip
253 @ip.setter
254 def ip(self, ip: str):
255 """Sets the ip of this Identification.
257 IP address of the requesting browser or bot. # noqa: E501
259 :param ip: The ip of this Identification. # noqa: E501
260 """
261 if ip is None:
262 raise ValueError("Invalid value for `ip`, must not be `None`") # noqa: E501
264 self._ip = ip
266 @property
267 def ip_location(self) -> Optional[DeprecatedGeolocation]:
268 """Gets the ip_location of this Identification. # noqa: E501
271 :return: The ip_location of this Identification. # noqa: E501
272 """
273 return self._ip_location
275 @ip_location.setter
276 def ip_location(self, ip_location: Optional[DeprecatedGeolocation]):
277 """Sets the ip_location of this Identification.
280 :param ip_location: The ip_location of this Identification. # noqa: E501
281 """
283 self._ip_location = ip_location
285 @property
286 def linked_id(self) -> Optional[str]:
287 """Gets the linked_id of this Identification. # noqa: E501
289 A customer-provided id that was sent with the request. # noqa: E501
291 :return: The linked_id of this Identification. # noqa: E501
292 """
293 return self._linked_id
295 @linked_id.setter
296 def linked_id(self, linked_id: Optional[str]):
297 """Sets the linked_id of this Identification.
299 A customer-provided id that was sent with the request. # noqa: E501
301 :param linked_id: The linked_id of this Identification. # noqa: E501
302 """
304 self._linked_id = linked_id
306 @property
307 def suspect(self) -> Optional[bool]:
308 """Gets the suspect of this Identification. # noqa: E501
310 Field is `true` if you have previously set the `suspect` flag for this event using the [Server API Update event endpoint](https://dev.fingerprint.com/reference/updateevent). # noqa: E501
312 :return: The suspect of this Identification. # noqa: E501
313 """
314 return self._suspect
316 @suspect.setter
317 def suspect(self, suspect: Optional[bool]):
318 """Sets the suspect of this Identification.
320 Field is `true` if you have previously set the `suspect` flag for this event using the [Server API Update event endpoint](https://dev.fingerprint.com/reference/updateevent). # noqa: E501
322 :param suspect: The suspect of this Identification. # noqa: E501
323 """
325 self._suspect = suspect
327 @property
328 def timestamp(self) -> int:
329 """Gets the timestamp of this Identification. # noqa: E501
331 Timestamp of the event with millisecond precision in Unix time. # noqa: E501
333 :return: The timestamp of this Identification. # noqa: E501
334 """
335 return self._timestamp
337 @timestamp.setter
338 def timestamp(self, timestamp: int):
339 """Sets the timestamp of this Identification.
341 Timestamp of the event with millisecond precision in Unix time. # noqa: E501
343 :param timestamp: The timestamp of this Identification. # noqa: E501
344 """
345 if timestamp is None:
346 raise ValueError("Invalid value for `timestamp`, must not be `None`") # noqa: E501
348 self._timestamp = timestamp
350 @property
351 def time(self) -> datetime:
352 """Gets the time of this Identification. # noqa: E501
354 Time expressed according to ISO 8601 in UTC format, when the request from the JS agent was made. We recommend to treat requests that are older than 2 minutes as malicious. Otherwise, request replay attacks are possible. # noqa: E501
356 :return: The time of this Identification. # noqa: E501
357 """
358 return self._time
360 @time.setter
361 def time(self, time: datetime):
362 """Sets the time of this Identification.
364 Time expressed according to ISO 8601 in UTC format, when the request from the JS agent was made. We recommend to treat requests that are older than 2 minutes as malicious. Otherwise, request replay attacks are possible. # noqa: E501
366 :param time: The time of this Identification. # noqa: E501
367 """
368 if time is None:
369 raise ValueError("Invalid value for `time`, must not be `None`") # noqa: E501
371 self._time = time
373 @property
374 def url(self) -> str:
375 """Gets the url of this Identification. # noqa: E501
377 Page URL from which the request was sent. # noqa: E501
379 :return: The url of this Identification. # noqa: E501
380 """
381 return self._url
383 @url.setter
384 def url(self, url: str):
385 """Sets the url of this Identification.
387 Page URL from which the request was sent. # noqa: E501
389 :param url: The url of this Identification. # noqa: E501
390 """
391 if url is None:
392 raise ValueError("Invalid value for `url`, must not be `None`") # noqa: E501
394 self._url = url
396 @property
397 def tag(self) -> Tag:
398 """Gets the tag of this Identification. # noqa: E501
401 :return: The tag of this Identification. # noqa: E501
402 """
403 return self._tag
405 @tag.setter
406 def tag(self, tag: Tag):
407 """Sets the tag of this Identification.
410 :param tag: The tag of this Identification. # noqa: E501
411 """
412 if tag is None:
413 raise ValueError("Invalid value for `tag`, must not be `None`") # noqa: E501
415 self._tag = tag
417 @property
418 def confidence(self) -> Optional[IdentificationConfidence]:
419 """Gets the confidence of this Identification. # noqa: E501
422 :return: The confidence of this Identification. # noqa: E501
423 """
424 return self._confidence
426 @confidence.setter
427 def confidence(self, confidence: Optional[IdentificationConfidence]):
428 """Sets the confidence of this Identification.
431 :param confidence: The confidence of this Identification. # noqa: E501
432 """
434 self._confidence = confidence
436 @property
437 def visitor_found(self) -> bool:
438 """Gets the visitor_found of this Identification. # noqa: E501
440 Attribute represents if a visitor had been identified before. # noqa: E501
442 :return: The visitor_found of this Identification. # noqa: E501
443 """
444 return self._visitor_found
446 @visitor_found.setter
447 def visitor_found(self, visitor_found: bool):
448 """Sets the visitor_found of this Identification.
450 Attribute represents if a visitor had been identified before. # noqa: E501
452 :param visitor_found: The visitor_found of this Identification. # noqa: E501
453 """
454 if visitor_found is None:
455 raise ValueError("Invalid value for `visitor_found`, must not be `None`") # noqa: E501
457 self._visitor_found = visitor_found
459 @property
460 def first_seen_at(self) -> IdentificationSeenAt:
461 """Gets the first_seen_at of this Identification. # noqa: E501
464 :return: The first_seen_at of this Identification. # noqa: E501
465 """
466 return self._first_seen_at
468 @first_seen_at.setter
469 def first_seen_at(self, first_seen_at: IdentificationSeenAt):
470 """Sets the first_seen_at of this Identification.
473 :param first_seen_at: The first_seen_at of this Identification. # noqa: E501
474 """
475 if first_seen_at is None:
476 raise ValueError("Invalid value for `first_seen_at`, must not be `None`") # noqa: E501
478 self._first_seen_at = first_seen_at
480 @property
481 def last_seen_at(self) -> IdentificationSeenAt:
482 """Gets the last_seen_at of this Identification. # noqa: E501
485 :return: The last_seen_at of this Identification. # noqa: E501
486 """
487 return self._last_seen_at
489 @last_seen_at.setter
490 def last_seen_at(self, last_seen_at: IdentificationSeenAt):
491 """Sets the last_seen_at of this Identification.
494 :param last_seen_at: The last_seen_at of this Identification. # noqa: E501
495 """
496 if last_seen_at is None:
497 raise ValueError("Invalid value for `last_seen_at`, must not be `None`") # noqa: E501
499 self._last_seen_at = last_seen_at
501 @property
502 def components(self) -> Optional[RawDeviceAttributes]:
503 """Gets the components of this Identification. # noqa: E501
506 :return: The components of this Identification. # noqa: E501
507 """
508 return self._components
510 @components.setter
511 def components(self, components: Optional[RawDeviceAttributes]):
512 """Sets the components of this Identification.
515 :param components: The components of this Identification. # noqa: E501
516 """
518 self._components = components
520 @property
521 def replayed(self) -> bool:
522 """Gets the replayed of this Identification. # noqa: E501
524 `true` if we determined that this payload was replayed, `false` otherwise. # noqa: E501
526 :return: The replayed of this Identification. # noqa: E501
527 """
528 return self._replayed
530 @replayed.setter
531 def replayed(self, replayed: bool):
532 """Sets the replayed of this Identification.
534 `true` if we determined that this payload was replayed, `false` otherwise. # noqa: E501
536 :param replayed: The replayed of this Identification. # noqa: E501
537 """
538 if replayed is None:
539 raise ValueError("Invalid value for `replayed`, must not be `None`") # noqa: E501
541 self._replayed = replayed
543 @property
544 def sdk(self) -> Optional[SDK]:
545 """Gets the sdk of this Identification. # noqa: E501
548 :return: The sdk of this Identification. # noqa: E501
549 """
550 return self._sdk
552 @sdk.setter
553 def sdk(self, sdk: Optional[SDK]):
554 """Sets the sdk of this Identification.
557 :param sdk: The sdk of this Identification. # noqa: E501
558 """
560 self._sdk = sdk