saasus_sdk_python 0.2.0.dev20250404074154__tar.gz → 1.13.18__tar.gz

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: saasus_sdk_python
-Version: 0.2.0.dev20250404074154
+Version: 1.13.18
 Summary: SaaSus Auth API Schema
 Home-page: https://github.com/saasus-platform/saasus-sdk-python
 License: Apache-2.0
@@ -39,12 +39,19 @@ Python 3.7+
 ## Installation & Usage
 ### pip install
 
-If the python package is hosted on a repository, you can install directly using:
+You can install directly from the GitHub repository:
 
 ```sh
-pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
+# Install a specific version (recommended for production)
+pip install git+https://github.com/saasus-platform/saasus-sdk-python.git@v1.0.0
+
+# Or install the latest development version
+pip install git+https://github.com/saasus-platform/saasus-sdk-python.git
 ```
-(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git`)
+
+For production use, we recommend installing a specific version tag. See [releases](https://github.com/saasus-platform/saasus-sdk-python/releases) for available versions.
+
+(you may need to run `pip` with root permission)
 
 Then import the package:
 ```python
@@ -74,41 +81,30 @@ Execute `pytest` to run the tests.
 Please follow the [installation procedure](#installation--usage) and then run the following:
 
 ```python
-
-import time
-import saasus_sdk_python
-from saasus_sdk_python.rest import ApiException
+from saasus_sdk_python.client.auth_client import SignedAuthApiClient
+from saasus_sdk_python.src.auth.api.auth_info_api import AuthInfoApi
+from saasus_sdk_python.src.auth.exceptions import ApiException
 from pprint import pprint
 
-# Defining the host is optional and defaults to https://api.saasus.io/v1/auth
-# See configuration.py for a list of all supported configuration parameters.
-configuration = saasus_sdk_python.Configuration(
-    host = "https://api.saasus.io/v1/auth"
-)
-
-# The client must configure the authentication and authorization parameters
-# in accordance with the API server security policy.
-# Examples for each auth method are provided below, use the example that
-# satisfies your auth use case.
-
-# Configure Bearer authorization: Bearer
-configuration = saasus_sdk_python.Configuration(
-    access_token = os.environ["BEARER_TOKEN"]
-)
-
-
-# Enter a context with an instance of the API client
-with saasus_sdk_python.ApiClient(configuration) as api_client:
-    # Create an instance of the API class
-    api_instance = saasus_sdk_python.AuthInfoApi(api_client)
-
-    try:
-        # 認証情報を取得(Get Authentication Info)
-        api_response = api_instance.get_auth_info()
-        print("The response of AuthInfoApi->get_auth_info:\n")
-        pprint(api_response)
-    except ApiException as e:
-        print("Exception when calling AuthInfoApi->get_auth_info: %s\n" % e)
+# Set authentication information from environment variables
+# Please set the following in .env file or environment variables:
+# SAASUS_API_KEY=your_api_key
+# SAASUS_SECRET_KEY=your_secret_key
+# SAASUS_SAAS_ID=your_saas_id
+
+# Create signed API client
+api_client = SignedAuthApiClient()
+
+# Create API instance
+api_instance = AuthInfoApi(api_client)
+
+try:
+    # Get Authentication Info
+    api_response = api_instance.get_auth_info()
+    print("The response of AuthInfoApi->get_auth_info:\n")
+    pprint(api_response)
+except ApiException as e:
+    print("Exception when calling AuthInfoApi->get_auth_info: %s\n" % e)
 
 ```
 

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/README.md

@@ -14,12 +14,19 @@ Python 3.7+
 ## Installation & Usage
 ### pip install
 
-If the python package is hosted on a repository, you can install directly using:
+You can install directly from the GitHub repository:
 
 ```sh
-pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
+# Install a specific version (recommended for production)
+pip install git+https://github.com/saasus-platform/saasus-sdk-python.git@v1.0.0
+
+# Or install the latest development version
+pip install git+https://github.com/saasus-platform/saasus-sdk-python.git
 ```
-(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git`)
+
+For production use, we recommend installing a specific version tag. See [releases](https://github.com/saasus-platform/saasus-sdk-python/releases) for available versions.
+
+(you may need to run `pip` with root permission)
 
 Then import the package:
 ```python
@@ -49,41 +56,30 @@ Execute `pytest` to run the tests.
 Please follow the [installation procedure](#installation--usage) and then run the following:
 
 ```python
-
-import time
-import saasus_sdk_python
-from saasus_sdk_python.rest import ApiException
+from saasus_sdk_python.client.auth_client import SignedAuthApiClient
+from saasus_sdk_python.src.auth.api.auth_info_api import AuthInfoApi
+from saasus_sdk_python.src.auth.exceptions import ApiException
 from pprint import pprint
 
-# Defining the host is optional and defaults to https://api.saasus.io/v1/auth
-# See configuration.py for a list of all supported configuration parameters.
-configuration = saasus_sdk_python.Configuration(
-    host = "https://api.saasus.io/v1/auth"
-)
-
-# The client must configure the authentication and authorization parameters
-# in accordance with the API server security policy.
-# Examples for each auth method are provided below, use the example that
-# satisfies your auth use case.
-
-# Configure Bearer authorization: Bearer
-configuration = saasus_sdk_python.Configuration(
-    access_token = os.environ["BEARER_TOKEN"]
-)
-
-
-# Enter a context with an instance of the API client
-with saasus_sdk_python.ApiClient(configuration) as api_client:
-    # Create an instance of the API class
-    api_instance = saasus_sdk_python.AuthInfoApi(api_client)
-
-    try:
-        # 認証情報を取得(Get Authentication Info)
-        api_response = api_instance.get_auth_info()
-        print("The response of AuthInfoApi->get_auth_info:\n")
-        pprint(api_response)
-    except ApiException as e:
-        print("Exception when calling AuthInfoApi->get_auth_info: %s\n" % e)
+# Set authentication information from environment variables
+# Please set the following in .env file or environment variables:
+# SAASUS_API_KEY=your_api_key
+# SAASUS_SECRET_KEY=your_secret_key
+# SAASUS_SAAS_ID=your_saas_id
+
+# Create signed API client
+api_client = SignedAuthApiClient()
+
+# Create API instance
+api_instance = AuthInfoApi(api_client)
+
+try:
+    # Get Authentication Info
+    api_response = api_instance.get_auth_info()
+    print("The response of AuthInfoApi->get_auth_info:\n")
+    pprint(api_response)
+except ApiException as e:
+    print("Exception when calling AuthInfoApi->get_auth_info: %s\n" % e)
 
 ```
 

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "saasus_sdk_python"
-version = "0.2.0.dev20250404074154"
+version = "1.13.18"
 description = "SaaSus Auth API Schema"
 authors = ["Anti-Pattern Inc. <saasus@anti-pattern.co.jp>"]
 license = "Apache-2.0"
@@ -34,6 +34,11 @@ flake8 = "^3.7.0"
 pydantic-core = "^2.4.0"
 bump-pydantic = "^0.8.0"
 
+[tool.poetry.group.test.dependencies]
+pytest = "^7.4.0"
+# Contract suite (tests/contract): parses the OpenAPI spec YAML.
+pyyaml = "^6.0"
+
 [build-system]
 requires = ["poetry-core"]
 build-backend = "poetry.core.masonry.api"

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/__main__.py

@@ -49,7 +49,8 @@ def fastapi_auth(request: Request) -> Union[dict, HTTPException]:
     auth_header = request.headers.get("Authorization", "")
     token = auth_header.replace("Bearer ", "") if "Bearer " in auth_header else ""
     referer = request.headers.get("Referer", "")
-    user_info, error = auth.authenticate(id_token=token, referer=referer)
+    x_saasus_trace_id = request.headers.get("X-SaaSus-Trace-Id", "")
+    user_info, error = auth.authenticate(id_token=token, referer=referer, x_saasus_trace_id=x_saasus_trace_id)
     if error:
         raise HTTPException(status_code=401, detail=str(error))
     return user_info

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/apilog_client.py

@@ -6,12 +6,13 @@ from saasus_sdk_python.src.apilog.api_client import ApiClient
 
 class SignedApilogApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
     def call_api(self, resource_path, method,
@@ -24,15 +25,20 @@ class SignedApilogApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/apilog"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/auth_client.py

@@ -6,10 +6,11 @@ from saasus_sdk_python.src.auth.api_client import ApiClient
 
 class SignedAuthApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         self.client = Client()
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
         super().__init__(*args, **kwargs)
 
@@ -23,15 +24,20 @@ class SignedAuthApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/auth"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/awsmarketplace_client.py

@@ -6,12 +6,13 @@ from saasus_sdk_python.src.awsmarketplace.api_client import ApiClient
 
 class SignedAwsmarketplaceApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
     def call_api(self, resource_path, method,
@@ -24,15 +25,20 @@ class SignedAwsmarketplaceApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/awsmarketplace"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/billing_client.py

@@ -6,12 +6,13 @@ from saasus_sdk_python.src.billing.api_client import ApiClient
 
 class SignedBillingApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
     def call_api(self, resource_path, method,
@@ -24,15 +25,20 @@ class SignedBillingApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/billing"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/client.py

@@ -26,6 +26,7 @@ class Client:
             cls._instance = super().__new__(cls)
             cls._instance.referer = None
             cls._instance.x_saasus_referer = None
+            cls._instance.x_saasus_trace_id = None
             cls._instance.api_key = os.getenv("SAASUS_API_KEY", "")
             cls._instance.secret_key = os.getenv("SAASUS_SECRET_KEY", "")
             cls._instance.saas_id = os.getenv("SAASUS_SAAS_ID", "")
@@ -55,4 +56,6 @@ class Client:
             header_params["Referer"] = self.referer
         if self.x_saasus_referer:
             header_params["X-SaaSus-Referer"] = self.x_saasus_referer
+        if self.x_saasus_trace_id:
+            header_params["X-SaaSus-Trace-Id"] = self.x_saasus_trace_id
         return header_params

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/communication_client.py

@@ -6,12 +6,13 @@ from saasus_sdk_python.src.communication.api_client import ApiClient
 
 class SignedCommunicationApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
     def call_api(self, resource_path, method,
@@ -24,16 +25,20 @@ class SignedCommunicationApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/communication"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
 
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/integration_client.py

@@ -6,12 +6,13 @@ from saasus_sdk_python.src.integration.api_client import ApiClient
 
 class SignedIntegrationApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
     def call_api(self, resource_path, method,
@@ -24,15 +25,20 @@ class SignedIntegrationApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.configuration.host = f"{self.base_url}/integration"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/client/pricing_client.py

@@ -5,12 +5,13 @@ from saasus_sdk_python.src.pricing.api_client import ApiClient
 
 class SignedPricingApiClient(ApiClient):
 
-    def __init__(self, referer=None, x_saasus_referer=None, *args, **kwargs):
+    def __init__(self, referer=None, x_saasus_referer=None, *args, x_saasus_trace_id=None, **kwargs):
         super().__init__(*args, **kwargs)
         self.client = Client()
         self.configuration.default_headers = {}
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
 
     def call_api(self, resource_path, method,
                  path_params=None, query_params=None, header_params=None,
@@ -22,16 +23,21 @@ class SignedPricingApiClient(ApiClient):
 
         if path_params:
             resource_path = resource_path.format(**path_params)
-        if query_params:
-            query_string = urlencode(query_params)
-            resource_path += f"?{query_string}"
 
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
         self.configuration.host = f"{self.base_url}/pricing"
 
+        # 署名用にフル URL を組み立てる（パス + 正規化済みクエリ）
+        sanitized = self.sanitize_for_serialization(query_params or {})
+        query_str = self.parameters_to_url_query(sanitized, collection_formats)
+
+        url_for_sig = self.configuration.host + resource_path
+        if query_str:
+            url_for_sig += "?" + query_str
+
         # 署名ヘッダを生成してリクエストヘッダに追加する
         signature_headers = self.client.generate_signature(
-            method, self.configuration.host + resource_path, body
+            method, url_for_sig, body
         )
 
         # header_paramsを署名つきのヘッダで更新する。

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/middleware/middleware.py

@@ -26,12 +26,13 @@ class Authenticate:
         self.client = Client()
         self.base_url = os.getenv("SAASUS_BASE_URL", "https://api.saasus.io/v1")
 
-    def authenticate(self, id_token: str, referer: str | None = None, x_saasus_referer: str | None = None) -> tuple[None, AuthenticationError] | tuple[UserInfo, None] | tuple[None, ErrorResponse]:  # noqa: E501
+    def authenticate(self, id_token: str, referer: str | None = None, x_saasus_referer: str | None = None, x_saasus_trace_id: str | None = None) -> tuple[None, AuthenticationError] | tuple[UserInfo, None] | tuple[None, ErrorResponse]:  # noqa: E501
         if not id_token:
             return None, AuthenticationError("Invalid Authorization header")
 
         self.client.referer = referer
         self.client.x_saasus_referer = x_saasus_referer
+        self.client.x_saasus_trace_id = x_saasus_trace_id
         try:
             response = self.user_info(id_token)
             return response, None

{saasus_sdk_python-0.2.0.dev20250404074154 → saasus_sdk_python-1.13.18}/saasus_sdk_python/src/apilog/api/api_log_api.py

@@ -21,7 +21,7 @@ from typing_extensions import Annotated
 
 from datetime import date, datetime
 
-from pydantic import Field, StrictStr
+from pydantic import Field, StrictInt, StrictStr
 
 from typing import Optional
 
@@ -189,22 +189,26 @@ class ApiLogApi(object):
             _request_auth=_params.get('_request_auth'))
 
     @validate_arguments
-    def get_logs(self, created_date : Annotated[Optional[date], Field(description="The date, in format of YYYY-MM-DD, to retrieve the log.")] = None, created_at : Annotated[Optional[datetime], Field(description="The datetime, in ISO 8601 format, to retrieve the log.")] = None, limit : Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Maximum number of logs to retrieve.")] = None, cursor : Annotated[Optional[StrictStr], Field(description="Cursor for cursor pagination.")] = None, **kwargs) -> ApiLogs:  # noqa: E501
+    def get_logs(self, created_date : Annotated[Optional[date], Field(description="The date, in format of YYYY-MM-DD, to retrieve the log.")] = None, created_at : Annotated[Optional[datetime], Field(description="The datetime, in ISO 8601 format, to retrieve the log. Cannot be specified together with start_at/end_at.")] = None, limit : Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Maximum number of logs to retrieve.")] = None, start_at : Annotated[Optional[StrictInt], Field(description="The start of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.")] = None, end_at : Annotated[Optional[StrictInt], Field(description="The end of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.")] = None, cursor : Annotated[Optional[StrictStr], Field(description="Cursor for cursor pagination.")] = None, **kwargs) -> ApiLogs:  # noqa: E501
         """Get API execution log list  # noqa: E501
 
         Retrieve the log of all API executions.  # noqa: E501
         This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please pass async_req=True
 
-        >>> thread = api.get_logs(created_date, created_at, limit, cursor, async_req=True)
+        >>> thread = api.get_logs(created_date, created_at, limit, start_at, end_at, cursor, async_req=True)
         >>> result = thread.get()
 
         :param created_date: The date, in format of YYYY-MM-DD, to retrieve the log.
         :type created_date: date
-        :param created_at: The datetime, in ISO 8601 format, to retrieve the log.
+        :param created_at: The datetime, in ISO 8601 format, to retrieve the log. Cannot be specified together with start_at/end_at.
         :type created_at: datetime
         :param limit: Maximum number of logs to retrieve.
         :type limit: int
+        :param start_at: The start of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.
+        :type start_at: int
+        :param end_at: The end of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.
+        :type end_at: int
         :param cursor: Cursor for cursor pagination.
         :type cursor: str
         :param async_req: Whether to execute the request asynchronously.
@@ -221,25 +225,29 @@ class ApiLogApi(object):
         kwargs['_return_http_data_only'] = True
         if '_preload_content' in kwargs:
             raise ValueError("Error! Please call the get_logs_with_http_info method with `_preload_content` instead and obtain raw data from ApiResponse.raw_data")
-        return self.get_logs_with_http_info(created_date, created_at, limit, cursor, **kwargs)  # noqa: E501
+        return self.get_logs_with_http_info(created_date, created_at, limit, start_at, end_at, cursor, **kwargs)  # noqa: E501
 
     @validate_arguments
-    def get_logs_with_http_info(self, created_date : Annotated[Optional[date], Field(description="The date, in format of YYYY-MM-DD, to retrieve the log.")] = None, created_at : Annotated[Optional[datetime], Field(description="The datetime, in ISO 8601 format, to retrieve the log.")] = None, limit : Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Maximum number of logs to retrieve.")] = None, cursor : Annotated[Optional[StrictStr], Field(description="Cursor for cursor pagination.")] = None, **kwargs) -> ApiResponse:  # noqa: E501
+    def get_logs_with_http_info(self, created_date : Annotated[Optional[date], Field(description="The date, in format of YYYY-MM-DD, to retrieve the log.")] = None, created_at : Annotated[Optional[datetime], Field(description="The datetime, in ISO 8601 format, to retrieve the log. Cannot be specified together with start_at/end_at.")] = None, limit : Annotated[Optional[Annotated[int, Field(strict=True, ge=1)]], Field(description="Maximum number of logs to retrieve.")] = None, start_at : Annotated[Optional[StrictInt], Field(description="The start of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.")] = None, end_at : Annotated[Optional[StrictInt], Field(description="The end of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.")] = None, cursor : Annotated[Optional[StrictStr], Field(description="Cursor for cursor pagination.")] = None, **kwargs) -> ApiResponse:  # noqa: E501
         """Get API execution log list  # noqa: E501
 
         Retrieve the log of all API executions.  # noqa: E501
         This method makes a synchronous HTTP request by default. To make an
         asynchronous HTTP request, please pass async_req=True
 
-        >>> thread = api.get_logs_with_http_info(created_date, created_at, limit, cursor, async_req=True)
+        >>> thread = api.get_logs_with_http_info(created_date, created_at, limit, start_at, end_at, cursor, async_req=True)
         >>> result = thread.get()
 
         :param created_date: The date, in format of YYYY-MM-DD, to retrieve the log.
         :type created_date: date
-        :param created_at: The datetime, in ISO 8601 format, to retrieve the log.
+        :param created_at: The datetime, in ISO 8601 format, to retrieve the log. Cannot be specified together with start_at/end_at.
         :type created_at: datetime
         :param limit: Maximum number of logs to retrieve.
         :type limit: int
+        :param start_at: The start of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.
+        :type start_at: int
+        :param end_at: The end of the search range as an epoch second timestamp. Used for range search. Cannot be specified together with created_at. When specified, created_date is ignored.
+        :type end_at: int
         :param cursor: Cursor for cursor pagination.
         :type cursor: str
         :param async_req: Whether to execute the request asynchronously.
@@ -273,6 +281,8 @@ class ApiLogApi(object):
             'created_date',
             'created_at',
             'limit',
+            'start_at',
+            'end_at',
             'cursor'
         ]
         _all_params.extend(
@@ -319,6 +329,12 @@ class ApiLogApi(object):
         if _params.get('limit') is not None:  # noqa: E501
             _query_params.append(('limit', _params['limit']))
 
+        if _params.get('start_at') is not None:  # noqa: E501
+            _query_params.append(('start_at', _params['start_at']))
+
+        if _params.get('end_at') is not None:  # noqa: E501
+            _query_params.append(('end_at', _params['end_at']))
+
         if _params.get('cursor') is not None:  # noqa: E501
             _query_params.append(('cursor', _params['cursor']))