fingerprint-pro-server-api-sdk 8.2.1.dev0__tar.gz → 8.3.0__tar.gz

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fingerprint-pro-server-api-sdk
-Version: 8.2.1.dev0
+Version: 8.3.0
 Summary: Fingerprint Pro Server API allows you to get information about visitors and about individual 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. 
 Author: Fingerprint
 Author-email: support@fingerprint.com
@@ -61,7 +61,7 @@ The Fingerprint Server Python SDK is an easy way to interact with the Fingerprin
 This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 3
-- Package version: 8.2.1-dev.0
+- Package version: 8.3.0
 - Build package: io.swagger.codegen.v3.generators.python.PythonClientCodegen
 
 ## Requirements
@@ -184,6 +184,36 @@ except ApiException as e:
     print("Exception when calling FingerprintApi->get_event: %s\n" % e)
 ```
 
+Search events with custom filters:
+```python
+import fingerprint_pro_server_api_sdk
+from fingerprint_pro_server_api_sdk.rest import ApiException, KnownApiException
+
+configuration = fingerprint_pro_server_api_sdk.Configuration(api_key="SECRET_API_KEY")
+api_instance = fingerprint_pro_server_api_sdk.FingerprintApi(configuration)
+
+limit = 20                      # int | Limit the number of events returned.
+visitor_id = 'VISITOR_ID'       # str | Unique [visitor identifier](https://dev.fingerprint.com/reference/get-function#visitorid) issued by Fingerprint Pro. Filter for events matching this `visitor_id`.  (optional)
+bot = 'good'                    # str | Filter events by the bot detection result, specifically: events where <'any'|'good'|'bad'|'none'> kind of bot was detected.  (optional)
+ip_address = '192.168.0.1/32'   # str | Filter events by IP address range. The range can be as specific as a single IP (/32 for IPv4 or /128 for IPv6)  All ip_address filters must use CIDR notation, for example, 10.0.0.0/24, 192.168.0.1/32  (optional)
+linked_id = 'linked_id_example' # str | Filter events by your custom identifier.   You can use [linked IDs](https://dev.fingerprint.com/reference/get-function#linkedid) to associate identification requests with your own identifier, for example, session ID, purchase ID, or transaction ID. You can then use this `linked_id` parameter to retrieve all events associated with your custom identifier.  (optional)
+start = 1738687200000           # int | Filter events with a timestamp greater than the start time, in Unix time (milliseconds).  (optional)
+end = 1738773600000             # int | Filter events with a timestamp smaller than the end time, in Unix time (milliseconds).  (optional)
+reverse = True                 # bool | Sort events in reverse timestamp order.  (optional)
+suspect = False                # bool | Filter events previously tagged as suspicious via the [Update API](https://dev.fingerprint.com/reference/updateevent).  (optional)
+
+try:
+    # Get events via search
+    api_response = api_instance.search_events(limit, visitor_id=visitor_id, bot=bot, ip_address=ip_address, linked_id=linked_id, start=start, end=end, reverse=reverse, suspect=suspect)
+    print(api_response)
+
+except KnownApiException as e:
+    structured_error = e.structured_error
+    print("Error code: %s. Error message: %s\n" % (structured_error.error.code, structured_error.error.message))
+except ApiException as e:
+    print("Exception when calling FingerprintApi->get_event: %s\n" % e)
+```
+
 Update event for requestId:
 ```python
 import fingerprint_pro_server_api_sdk
@@ -291,6 +321,7 @@ Class | Method | HTTP request | Description
 *FingerprintApi* | [**get_event**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_event) | **GET** /events/{request_id} | Get event by request ID
 *FingerprintApi* | [**get_related_visitors**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_related_visitors) | **GET** /related-visitors | Get Related Visitors
 *FingerprintApi* | [**get_visits**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_visits) | **GET** /visitors/{visitor_id} | Get visits by visitor ID
+*FingerprintApi* | [**search_events**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#search_events) | **GET** /events/search | Get events via search
 *FingerprintApi* | [**update_event**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#update_event) | **PUT** /events/{request_id} | Update an event with a given request ID
 
 ## Documentation For Models
@@ -365,6 +396,8 @@ Class | Method | HTTP request | Description
  - [RelatedVisitorsResponse](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RelatedVisitorsResponse.md)
  - [RemoteControl](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RemoteControl.md)
  - [RootApps](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RootApps.md)
+ - [SearchEventsResponse](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SearchEventsResponse.md)
+ - [SearchEventsResponseEvents](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SearchEventsResponseEvents.md)
  - [SuspectScore](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SuspectScore.md)
  - [Tag](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/Tag.md)
  - [Tampering](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/Tampering.md)

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/README.md

@@ -26,7 +26,7 @@ The Fingerprint Server Python SDK is an easy way to interact with the Fingerprin
 This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 3
-- Package version: 8.2.1-dev.0
+- Package version: 8.3.0
 - Build package: io.swagger.codegen.v3.generators.python.PythonClientCodegen
 
 ## Requirements
@@ -149,6 +149,36 @@ except ApiException as e:
     print("Exception when calling FingerprintApi->get_event: %s\n" % e)
 ```
 
+Search events with custom filters:
+```python
+import fingerprint_pro_server_api_sdk
+from fingerprint_pro_server_api_sdk.rest import ApiException, KnownApiException
+
+configuration = fingerprint_pro_server_api_sdk.Configuration(api_key="SECRET_API_KEY")
+api_instance = fingerprint_pro_server_api_sdk.FingerprintApi(configuration)
+
+limit = 20                      # int | Limit the number of events returned.
+visitor_id = 'VISITOR_ID'       # str | Unique [visitor identifier](https://dev.fingerprint.com/reference/get-function#visitorid) issued by Fingerprint Pro. Filter for events matching this `visitor_id`.  (optional)
+bot = 'good'                    # str | Filter events by the bot detection result, specifically: events where <'any'|'good'|'bad'|'none'> kind of bot was detected.  (optional)
+ip_address = '192.168.0.1/32'   # str | Filter events by IP address range. The range can be as specific as a single IP (/32 for IPv4 or /128 for IPv6)  All ip_address filters must use CIDR notation, for example, 10.0.0.0/24, 192.168.0.1/32  (optional)
+linked_id = 'linked_id_example' # str | Filter events by your custom identifier.   You can use [linked IDs](https://dev.fingerprint.com/reference/get-function#linkedid) to associate identification requests with your own identifier, for example, session ID, purchase ID, or transaction ID. You can then use this `linked_id` parameter to retrieve all events associated with your custom identifier.  (optional)
+start = 1738687200000           # int | Filter events with a timestamp greater than the start time, in Unix time (milliseconds).  (optional)
+end = 1738773600000             # int | Filter events with a timestamp smaller than the end time, in Unix time (milliseconds).  (optional)
+reverse = True                 # bool | Sort events in reverse timestamp order.  (optional)
+suspect = False                # bool | Filter events previously tagged as suspicious via the [Update API](https://dev.fingerprint.com/reference/updateevent).  (optional)
+
+try:
+    # Get events via search
+    api_response = api_instance.search_events(limit, visitor_id=visitor_id, bot=bot, ip_address=ip_address, linked_id=linked_id, start=start, end=end, reverse=reverse, suspect=suspect)
+    print(api_response)
+
+except KnownApiException as e:
+    structured_error = e.structured_error
+    print("Error code: %s. Error message: %s\n" % (structured_error.error.code, structured_error.error.message))
+except ApiException as e:
+    print("Exception when calling FingerprintApi->get_event: %s\n" % e)
+```
+
 Update event for requestId:
 ```python
 import fingerprint_pro_server_api_sdk
@@ -256,6 +286,7 @@ Class | Method | HTTP request | Description
 *FingerprintApi* | [**get_event**](docs/FingerprintApi.md#get_event) | **GET** /events/{request_id} | Get event by request ID
 *FingerprintApi* | [**get_related_visitors**](docs/FingerprintApi.md#get_related_visitors) | **GET** /related-visitors | Get Related Visitors
 *FingerprintApi* | [**get_visits**](docs/FingerprintApi.md#get_visits) | **GET** /visitors/{visitor_id} | Get visits by visitor ID
+*FingerprintApi* | [**search_events**](docs/FingerprintApi.md#search_events) | **GET** /events/search | Get events via search
 *FingerprintApi* | [**update_event**](docs/FingerprintApi.md#update_event) | **PUT** /events/{request_id} | Update an event with a given request ID
 
 ## Documentation For Models
@@ -330,6 +361,8 @@ Class | Method | HTTP request | Description
  - [RelatedVisitorsResponse](docs/RelatedVisitorsResponse.md)
  - [RemoteControl](docs/RemoteControl.md)
  - [RootApps](docs/RootApps.md)
+ - [SearchEventsResponse](docs/SearchEventsResponse.md)
+ - [SearchEventsResponseEvents](docs/SearchEventsResponseEvents.md)
  - [SuspectScore](docs/SuspectScore.md)
  - [Tag](docs/Tag.md)
  - [Tampering](docs/Tampering.md)

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk/__init__.py

@@ -90,6 +90,8 @@ from fingerprint_pro_server_api_sdk.models.related_visitor import RelatedVisitor
 from fingerprint_pro_server_api_sdk.models.related_visitors_response import RelatedVisitorsResponse
 from fingerprint_pro_server_api_sdk.models.remote_control import RemoteControl
 from fingerprint_pro_server_api_sdk.models.root_apps import RootApps
+from fingerprint_pro_server_api_sdk.models.search_events_response import SearchEventsResponse
+from fingerprint_pro_server_api_sdk.models.search_events_response_events import SearchEventsResponseEvents
 from fingerprint_pro_server_api_sdk.models.suspect_score import SuspectScore
 from fingerprint_pro_server_api_sdk.models.tag import Tag
 from fingerprint_pro_server_api_sdk.models.tampering import Tampering

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk/api/fingerprint_api.py

@@ -24,6 +24,7 @@ from fingerprint_pro_server_api_sdk.models.error_response import ErrorResponse
 from fingerprint_pro_server_api_sdk.models.events_get_response import EventsGetResponse  # noqa: F401
 from fingerprint_pro_server_api_sdk.models.events_update_request import EventsUpdateRequest  # noqa: F401
 from fingerprint_pro_server_api_sdk.models.related_visitors_response import RelatedVisitorsResponse  # noqa: F401
+from fingerprint_pro_server_api_sdk.models.search_events_response import SearchEventsResponse  # noqa: F401
 from fingerprint_pro_server_api_sdk.models.visitors_get_response import VisitorsGetResponse  # noqa: F401
 
 
@@ -103,7 +104,7 @@ class FingerprintApi:
         if 'visitor_id' in params:
             path_params['visitor_id'] = params['visitor_id']  # noqa: E501
 
-        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.2.1-dev.0')]
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
 
         header_params = {}
 
@@ -213,7 +214,7 @@ class FingerprintApi:
         if 'request_id' in params:
             path_params['request_id'] = params['request_id']  # noqa: E501
 
-        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.2.1-dev.0')]
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
 
         header_params = {}
 
@@ -315,7 +316,7 @@ class FingerprintApi:
 
         path_params = {}
 
-        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.2.1-dev.0')]
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
         if 'visitor_id' in params:
             query_params.append(('visitor_id', params['visitor_id']))  # noqa: E501
 
@@ -442,7 +443,7 @@ class FingerprintApi:
         if 'visitor_id' in params:
             path_params['visitor_id'] = params['visitor_id']  # noqa: E501
 
-        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.2.1-dev.0')]
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
         if 'request_id' in params:
             query_params.append(('request_id', params['request_id']))  # noqa: E501
         if 'linked_id' in params:
@@ -495,6 +496,150 @@ class FingerprintApi:
                 raise extend_exception(e, error)
             raise e
 
+    def search_events(self, limit: int, **kwargs) -> Union[SearchEventsResponse, AsyncResult[SearchEventsResponse]]:  # noqa: E501
+        """Get events via search  # noqa: E501
+
+        Search for identification events, including Smart Signals, using multiple filtering criteria. If you don't provide `start` or `end` parameters, the default search range is the last 7 days.  Please note that events include mobile signals (e.g. `rootApps`) even if the request originated from a non-mobile platform. We recommend you **ignore** mobile signals for such requests.   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.search_events(limit, async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param limit: Limit the number of events returned.  (required)
+        :param visitor_id: Unique [visitor identifier](https://dev.fingerprint.com/reference/get-function#visitorid) issued by Fingerprint Pro. Filter for events matching this `visitor_id`. 
+        :param bot: Filter events by the bot detection result, specifically:    `all` - events where any kind of bot was detected.   `good` - events where a good bot was detected.   `bad` - events where a bad bot was detected.   `none` - events where no bot was detected. 
+        :param ip_address: Filter events by IP address range. The range can be as specific as a single IP (/32 for IPv4 or /128 for IPv6)  All ip_address filters must use CIDR notation, for example, 10.0.0.0/24, 192.168.0.1/32 
+        :param linked_id: Filter events by your custom identifier.   You can use [linked IDs](https://dev.fingerprint.com/reference/get-function#linkedid) to associate identification requests with your own identifier, for example, session ID, purchase ID, or transaction ID. You can then use this `linked_id` parameter to retrieve all events associated with your custom identifier. 
+        :param start: Filter events with a timestamp greater than the start time, in Unix time (milliseconds). 
+        :param end: Filter events with a timestamp smaller than the end time, in Unix time (milliseconds). 
+        :param reverse: Sort events in reverse timestamp order. 
+        :param suspect: Filter events previously tagged as suspicious via the [Update API](https://dev.fingerprint.com/reference/updateevent).  > Note: When using this parameter, only events with the `suspect` property explicitly set to `true` or `false` are returned. Events with undefined `suspect` property are left out of the response. 
+        :return: SearchEventsResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('async_req'):
+            return self.search_events_with_http_info(limit, **kwargs)  # noqa: E501
+        else:
+            (data) = self.search_events_with_http_info(limit, **kwargs)  # noqa: E501
+            return data
+
+    def search_events_with_http_info(self, limit: int, **kwargs):  # noqa: E501
+        """Get events via search  # noqa: E501
+
+        Search for identification events, including Smart Signals, using multiple filtering criteria. If you don't provide `start` or `end` parameters, the default search range is the last 7 days.  Please note that events include mobile signals (e.g. `rootApps`) even if the request originated from a non-mobile platform. We recommend you **ignore** mobile signals for such requests.   # noqa: E501
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.search_events_with_http_info(limit, async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param int limit: Limit the number of events returned.  (required)
+        :param str visitor_id: Unique [visitor identifier](https://dev.fingerprint.com/reference/get-function#visitorid) issued by Fingerprint Pro. Filter for events matching this `visitor_id`. 
+        :param str bot: Filter events by the bot detection result, specifically:    `all` - events where any kind of bot was detected.   `good` - events where a good bot was detected.   `bad` - events where a bad bot was detected.   `none` - events where no bot was detected. 
+        :param str ip_address: Filter events by IP address range. The range can be as specific as a single IP (/32 for IPv4 or /128 for IPv6)  All ip_address filters must use CIDR notation, for example, 10.0.0.0/24, 192.168.0.1/32 
+        :param str linked_id: Filter events by your custom identifier.   You can use [linked IDs](https://dev.fingerprint.com/reference/get-function#linkedid) to associate identification requests with your own identifier, for example, session ID, purchase ID, or transaction ID. You can then use this `linked_id` parameter to retrieve all events associated with your custom identifier. 
+        :param int start: Filter events with a timestamp greater than the start time, in Unix time (milliseconds). 
+        :param int end: Filter events with a timestamp smaller than the end time, in Unix time (milliseconds). 
+        :param bool reverse: Sort events in reverse timestamp order. 
+        :param bool suspect: Filter events previously tagged as suspicious via the [Update API](https://dev.fingerprint.com/reference/updateevent).  > Note: When using this parameter, only events with the `suspect` property explicitly set to `true` or `false` are returned. Events with undefined `suspect` property are left out of the response. 
+        :return: SearchEventsResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = [
+            'limit',
+            'visitor_id',
+            'bot',
+            'ip_address',
+            'linked_id',
+            'start',
+            'end',
+            'reverse',
+            'suspect',
+            'async_req',
+            '_return_http_data_only',
+            '_preload_content',
+            '_request_timeout']
+
+        params = locals()
+        for key, val in params['kwargs'].items():
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method search_events" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'limit' is set
+        if 'limit' not in params or params['limit'] is None:
+            raise ValueError("Missing the required parameter `limit` when calling `search_events`")  # noqa: E501
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+        if 'visitor_id' in params:
+            query_params.append(('visitor_id', params['visitor_id']))  # noqa: E501
+        if 'bot' in params:
+            query_params.append(('bot', params['bot']))  # noqa: E501
+        if 'ip_address' in params:
+            query_params.append(('ip_address', params['ip_address']))  # noqa: E501
+        if 'linked_id' in params:
+            query_params.append(('linked_id', params['linked_id']))  # noqa: E501
+        if 'start' in params:
+            query_params.append(('start', params['start']))  # noqa: E501
+        if 'end' in params:
+            query_params.append(('end', params['end']))  # noqa: E501
+        if 'reverse' in params:
+            query_params.append(('reverse', params['reverse']))  # noqa: E501
+        if 'suspect' in params:
+            query_params.append(('suspect', params['suspect']))  # noqa: E501
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['ApiKeyHeader', 'ApiKeyQuery']  # noqa: E501
+
+        try:
+            return self.api_client.call_api(
+                '/events/search', 'GET',
+                path_params,
+                query_params,
+                header_params,
+                body=body_params,
+                post_params=form_params,
+                files=local_var_files,
+                response_type='SearchEventsResponse',  # noqa: E501
+                auth_settings=auth_settings,
+                async_req=params.get('async_req'),
+                _return_http_data_only=params.get('_return_http_data_only'),
+                _preload_content=params.get('_preload_content', True),
+                _request_timeout=params.get('_request_timeout'),
+                collection_formats=collection_formats)
+        except ApiException as e:
+            if e.status == 400:
+                error = self.api_client.deserialize(e, 'ErrorResponse', True)
+                raise extend_exception(e, error)
+            if e.status == 403:
+                error = self.api_client.deserialize(e, 'ErrorResponse', True)
+                raise extend_exception(e, error)
+            raise e
+
     def update_event(self, body: EventsUpdateRequest, request_id: str, **kwargs) -> Union[None, AsyncResult[None]]:  # noqa: E501
         """Update an event with a given request ID  # noqa: E501
 
@@ -565,7 +710,7 @@ class FingerprintApi:
         if 'request_id' in params:
             path_params['request_id'] = params['request_id']  # noqa: E501
 
-        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.2.1-dev.0')]
+        query_params = [('ii', 'fingerprint-pro-server-python-sdk/8.3.0')]
 
         header_params = {}
 

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk/api_client.py

@@ -79,7 +79,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'Swagger-Codegen/8.2.1-dev.0/python'
+        self.user_agent = 'Swagger-Codegen/8.3.0/python'
 
     def __del__(self):
         self.pool.close()

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk/configuration.py

@@ -210,5 +210,5 @@ class Configuration:
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
                "Version of the API: 3\n"\
-               "SDK Package Version: 8.2.1-dev.0".\
+               "SDK Package Version: 8.3.0".\
                format(env=sys.platform, pyversion=sys.version)

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk/models/__init__.py

@@ -82,6 +82,8 @@ from fingerprint_pro_server_api_sdk.models.related_visitor import RelatedVisitor
 from fingerprint_pro_server_api_sdk.models.related_visitors_response import RelatedVisitorsResponse
 from fingerprint_pro_server_api_sdk.models.remote_control import RemoteControl
 from fingerprint_pro_server_api_sdk.models.root_apps import RootApps
+from fingerprint_pro_server_api_sdk.models.search_events_response import SearchEventsResponse
+from fingerprint_pro_server_api_sdk.models.search_events_response_events import SearchEventsResponseEvents
 from fingerprint_pro_server_api_sdk.models.suspect_score import SuspectScore
 from fingerprint_pro_server_api_sdk.models.tag import Tag
 from fingerprint_pro_server_api_sdk.models.tampering import Tampering

fingerprint_pro_server_api_sdk-8.3.0/fingerprint_pro_server_api_sdk/models/search_events_response.py

@@ -0,0 +1,96 @@
+# coding: utf-8
+
+"""
+    Fingerprint Pro Server API
+
+    Fingerprint Pro Server API allows you to get information about visitors and about individual 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
+
+    OpenAPI spec version: 3
+    Contact: support@fingerprint.com
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+import re  # noqa: F401
+from typing import Dict, List, Optional  # noqa: F401
+from fingerprint_pro_server_api_sdk.base_model import BaseModel
+from fingerprint_pro_server_api_sdk.models.search_events_response_events import SearchEventsResponseEvents
+
+
+class SearchEventsResponse(BaseModel):
+    """
+    Contains a list of all identification events matching the specified search criteria.
+
+    NOTE: This class is auto generated by the swagger code generator program.
+
+    Do not edit the class manually.
+    """
+    """
+    Attributes:
+      swagger_types (dict): The key is attribute name
+                            and the value is attribute type.
+      attribute_map (dict): The key is attribute name
+                            and the value is json key in definition.
+    """
+    swagger_types = {
+        'events': 'list[SearchEventsResponseEvents]',
+        'pagination_key': 'str'
+    }
+
+    nullable_map = {
+        'events': False,
+        'pagination_key': False
+    }
+
+    attribute_map = {
+        'events': 'events',
+        'pagination_key': 'paginationKey'
+    }
+
+    def __init__(self, events=None, pagination_key=None):  # noqa: E501
+        """SearchEventsResponse - a model defined in Swagger"""  # noqa: E501
+        self._events = None
+        self._pagination_key = None
+        self.discriminator = None
+        if events is not None:
+            self.events = events
+        if pagination_key is not None:
+            self.pagination_key = pagination_key
+
+    @property
+    def events(self) -> Optional[List[SearchEventsResponseEvents]]:
+        """Gets the events of this SearchEventsResponse.  # noqa: E501
+
+
+        :return: The events of this SearchEventsResponse.  # noqa: E501
+        """
+        return self._events
+
+    @events.setter
+    def events(self, events: Optional[List[SearchEventsResponseEvents]]):
+        """Sets the events of this SearchEventsResponse.
+
+
+        :param events: The events of this SearchEventsResponse.  # noqa: E501
+        """
+
+        self._events = events
+
+    @property
+    def pagination_key(self) -> Optional[str]:
+        """Gets the pagination_key of this SearchEventsResponse.  # noqa: E501
+
+
+        :return: The pagination_key of this SearchEventsResponse.  # noqa: E501
+        """
+        return self._pagination_key
+
+    @pagination_key.setter
+    def pagination_key(self, pagination_key: Optional[str]):
+        """Sets the pagination_key of this SearchEventsResponse.
+
+
+        :param pagination_key: The pagination_key of this SearchEventsResponse.  # noqa: E501
+        """
+
+        self._pagination_key = pagination_key
+

fingerprint_pro_server_api_sdk-8.3.0/fingerprint_pro_server_api_sdk/models/search_events_response_events.py

@@ -0,0 +1,72 @@
+# coding: utf-8
+
+"""
+    Fingerprint Pro Server API
+
+    Fingerprint Pro Server API allows you to get information about visitors and about individual 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
+
+    OpenAPI spec version: 3
+    Contact: support@fingerprint.com
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+import re  # noqa: F401
+from typing import Dict, List, Optional  # noqa: F401
+from fingerprint_pro_server_api_sdk.base_model import BaseModel
+from fingerprint_pro_server_api_sdk.models.products import Products
+
+
+class SearchEventsResponseEvents(BaseModel):
+    """
+    Device intelligence results for the identification event.
+
+    NOTE: This class is auto generated by the swagger code generator program.
+
+    Do not edit the class manually.
+    """
+    """
+    Attributes:
+      swagger_types (dict): The key is attribute name
+                            and the value is attribute type.
+      attribute_map (dict): The key is attribute name
+                            and the value is json key in definition.
+    """
+    swagger_types = {
+        'products': 'Products'
+    }
+
+    nullable_map = {
+        'products': False
+    }
+
+    attribute_map = {
+        'products': 'products'
+    }
+
+    def __init__(self, products=None):  # noqa: E501
+        """SearchEventsResponseEvents - a model defined in Swagger"""  # noqa: E501
+        self._products = None
+        self.discriminator = None
+        self.products = products
+
+    @property
+    def products(self) -> Products:
+        """Gets the products of this SearchEventsResponseEvents.  # noqa: E501
+
+
+        :return: The products of this SearchEventsResponseEvents.  # noqa: E501
+        """
+        return self._products
+
+    @products.setter
+    def products(self, products: Products):
+        """Sets the products of this SearchEventsResponseEvents.
+
+
+        :param products: The products of this SearchEventsResponseEvents.  # noqa: E501
+        """
+        if products is None:
+            raise ValueError("Invalid value for `products`, must not be `None`")  # noqa: E501
+
+        self._products = products
+

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: fingerprint-pro-server-api-sdk
-Version: 8.2.1.dev0
+Version: 8.3.0
 Summary: Fingerprint Pro Server API allows you to get information about visitors and about individual 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. 
 Author: Fingerprint
 Author-email: support@fingerprint.com
@@ -61,7 +61,7 @@ The Fingerprint Server Python SDK is an easy way to interact with the Fingerprin
 This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
 
 - API version: 3
-- Package version: 8.2.1-dev.0
+- Package version: 8.3.0
 - Build package: io.swagger.codegen.v3.generators.python.PythonClientCodegen
 
 ## Requirements
@@ -184,6 +184,36 @@ except ApiException as e:
     print("Exception when calling FingerprintApi->get_event: %s\n" % e)
 ```
 
+Search events with custom filters:
+```python
+import fingerprint_pro_server_api_sdk
+from fingerprint_pro_server_api_sdk.rest import ApiException, KnownApiException
+
+configuration = fingerprint_pro_server_api_sdk.Configuration(api_key="SECRET_API_KEY")
+api_instance = fingerprint_pro_server_api_sdk.FingerprintApi(configuration)
+
+limit = 20                      # int | Limit the number of events returned.
+visitor_id = 'VISITOR_ID'       # str | Unique [visitor identifier](https://dev.fingerprint.com/reference/get-function#visitorid) issued by Fingerprint Pro. Filter for events matching this `visitor_id`.  (optional)
+bot = 'good'                    # str | Filter events by the bot detection result, specifically: events where <'any'|'good'|'bad'|'none'> kind of bot was detected.  (optional)
+ip_address = '192.168.0.1/32'   # str | Filter events by IP address range. The range can be as specific as a single IP (/32 for IPv4 or /128 for IPv6)  All ip_address filters must use CIDR notation, for example, 10.0.0.0/24, 192.168.0.1/32  (optional)
+linked_id = 'linked_id_example' # str | Filter events by your custom identifier.   You can use [linked IDs](https://dev.fingerprint.com/reference/get-function#linkedid) to associate identification requests with your own identifier, for example, session ID, purchase ID, or transaction ID. You can then use this `linked_id` parameter to retrieve all events associated with your custom identifier.  (optional)
+start = 1738687200000           # int | Filter events with a timestamp greater than the start time, in Unix time (milliseconds).  (optional)
+end = 1738773600000             # int | Filter events with a timestamp smaller than the end time, in Unix time (milliseconds).  (optional)
+reverse = True                 # bool | Sort events in reverse timestamp order.  (optional)
+suspect = False                # bool | Filter events previously tagged as suspicious via the [Update API](https://dev.fingerprint.com/reference/updateevent).  (optional)
+
+try:
+    # Get events via search
+    api_response = api_instance.search_events(limit, visitor_id=visitor_id, bot=bot, ip_address=ip_address, linked_id=linked_id, start=start, end=end, reverse=reverse, suspect=suspect)
+    print(api_response)
+
+except KnownApiException as e:
+    structured_error = e.structured_error
+    print("Error code: %s. Error message: %s\n" % (structured_error.error.code, structured_error.error.message))
+except ApiException as e:
+    print("Exception when calling FingerprintApi->get_event: %s\n" % e)
+```
+
 Update event for requestId:
 ```python
 import fingerprint_pro_server_api_sdk
@@ -291,6 +321,7 @@ Class | Method | HTTP request | Description
 *FingerprintApi* | [**get_event**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_event) | **GET** /events/{request_id} | Get event by request ID
 *FingerprintApi* | [**get_related_visitors**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_related_visitors) | **GET** /related-visitors | Get Related Visitors
 *FingerprintApi* | [**get_visits**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#get_visits) | **GET** /visitors/{visitor_id} | Get visits by visitor ID
+*FingerprintApi* | [**search_events**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#search_events) | **GET** /events/search | Get events via search
 *FingerprintApi* | [**update_event**](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/FingerprintApi.md#update_event) | **PUT** /events/{request_id} | Update an event with a given request ID
 
 ## Documentation For Models
@@ -365,6 +396,8 @@ Class | Method | HTTP request | Description
  - [RelatedVisitorsResponse](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RelatedVisitorsResponse.md)
  - [RemoteControl](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RemoteControl.md)
  - [RootApps](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/RootApps.md)
+ - [SearchEventsResponse](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SearchEventsResponse.md)
+ - [SearchEventsResponseEvents](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SearchEventsResponseEvents.md)
  - [SuspectScore](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/SuspectScore.md)
  - [Tag](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/Tag.md)
  - [Tampering](https://github.com/fingerprintjs/fingerprint-pro-server-api-python-sdk/blob/main/docs/Tampering.md)

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/fingerprint_pro_server_api_sdk.egg-info/SOURCES.txt

@@ -89,6 +89,8 @@ fingerprint_pro_server_api_sdk/models/related_visitor.py
 fingerprint_pro_server_api_sdk/models/related_visitors_response.py
 fingerprint_pro_server_api_sdk/models/remote_control.py
 fingerprint_pro_server_api_sdk/models/root_apps.py
+fingerprint_pro_server_api_sdk/models/search_events_response.py
+fingerprint_pro_server_api_sdk/models/search_events_response_events.py
 fingerprint_pro_server_api_sdk/models/suspect_score.py
 fingerprint_pro_server_api_sdk/models/tag.py
 fingerprint_pro_server_api_sdk/models/tampering.py

{fingerprint_pro_server_api_sdk-8.2.1.dev0 → fingerprint_pro_server_api_sdk-8.3.0}/setup.cfg

@@ -1,5 +1,5 @@
 [metadata]
-version = 8.2.1-dev.0
+version = 8.3.0
 
 [egg_info]
 tag_build =