gmt-python-sdk 0.42.0__tar.gz → 0.43.0__tar.gz

gmt_python_sdk-0.43.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.43.0"
+}

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.43.0 (2026-05-21)
+
+Full Changelog: [v0.42.0...v0.43.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.42.0...v0.43.0)
+
+### Features
+
+* **api:** api update ([08eda67](https://github.com/cameo6/gmt-python-sdk/commit/08eda67407c3e8ea0b2f68df6e930bbdb7a58210))
+
 ## 0.42.0 (2026-05-20)
 
 Full Changelog: [v0.41.0...v0.42.0](https://github.com/cameo6/gmt-python-sdk/compare/v0.41.0...v0.42.0)

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: gmt-python-sdk
-Version: 0.42.0
+Version: 0.43.0
 Summary: The official Python library for the gmt API
 Project-URL: Homepage, https://github.com/cameo6/gmt-python-sdk
 Project-URL: Repository, https://github.com/cameo6/gmt-python-sdk

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/api.md

@@ -118,7 +118,7 @@ Methods:
 
 - <code title="post /v1/purchases/bulk">client.purchases.bulk.<a href="./src/gmt/resources/purchases/bulk.py">create</a>(\*\*<a href="src/gmt/types/purchases/bulk_create_params.py">params</a>) -> <a href="./src/gmt/types/purchases/bulk_create_response.py">BulkCreateResponse</a></code>
 - <code title="get /v1/purchases/bulk/{purchase_id}">client.purchases.bulk.<a href="./src/gmt/resources/purchases/bulk.py">retrieve</a>(purchase_id) -> <a href="./src/gmt/types/purchases/bulk_retrieve_response.py">BulkRetrieveResponse</a></code>
-- <code title="get /v1/purchases/bulk/{purchase_id}/download">client.purchases.bulk.<a href="./src/gmt/resources/purchases/bulk.py">download</a>(purchase_id) -> BinaryAPIResponse</code>
+- <code title="get /v1/purchases/bulk/{purchase_id}/download">client.purchases.bulk.<a href="./src/gmt/resources/purchases/bulk.py">download</a>(purchase_id) -> None</code>
 
 # PurchasesByHash
 
@@ -136,39 +136,6 @@ Methods:
 - <code title="get /v1/purchases-by-hash/{hash}">client.purchases_by_hash.<a href="./src/gmt/resources/purchases_by_hash.py">retrieve</a>(hash) -> <a href="./src/gmt/types/purchases_by_hash_retrieve_response.py">PurchasesByHashRetrieveResponse</a></code>
 - <code title="post /v1/purchases-by-hash/{hash}/request-code">client.purchases_by_hash.<a href="./src/gmt/resources/purchases_by_hash.py">request_verification_code</a>(hash, \*\*<a href="src/gmt/types/purchases_by_hash_request_verification_code_params.py">params</a>) -> <a href="./src/gmt/types/purchases_by_hash_request_verification_code_response.py">PurchasesByHashRequestVerificationCodeResponse</a></code>
 
-# Telegram
-
-Types:
-
-```python
-from gmt.types import TelegramGetPremiumPriceResponse, TelegramGetStarsPriceResponse
-```
-
-Methods:
-
-- <code title="get /v1/telegram/premium">client.telegram.<a href="./src/gmt/resources/telegram/telegram.py">get_premium_price</a>(\*\*<a href="src/gmt/types/telegram_get_premium_price_params.py">params</a>) -> <a href="./src/gmt/types/telegram_get_premium_price_response.py">TelegramGetPremiumPriceResponse</a></code>
-- <code title="get /v1/telegram/stars">client.telegram.<a href="./src/gmt/resources/telegram/telegram.py">get_stars_price</a>(\*\*<a href="src/gmt/types/telegram_get_stars_price_params.py">params</a>) -> <a href="./src/gmt/types/telegram_get_stars_price_response.py">TelegramGetStarsPriceResponse</a></code>
-
-## Purchases
-
-Types:
-
-```python
-from gmt.types.telegram import (
-    PurchaseCreatePremiumResponse,
-    PurchaseCreateStarsResponse,
-    PurchaseListPremiumResponse,
-    PurchaseListStarsResponse,
-)
-```
-
-Methods:
-
-- <code title="post /v1/telegram/purchases/premium">client.telegram.purchases.<a href="./src/gmt/resources/telegram/purchases.py">create_premium</a>(\*\*<a href="src/gmt/types/telegram/purchase_create_premium_params.py">params</a>) -> <a href="./src/gmt/types/telegram/purchase_create_premium_response.py">PurchaseCreatePremiumResponse</a></code>
-- <code title="post /v1/telegram/purchases/stars">client.telegram.purchases.<a href="./src/gmt/resources/telegram/purchases.py">create_stars</a>(\*\*<a href="src/gmt/types/telegram/purchase_create_stars_params.py">params</a>) -> <a href="./src/gmt/types/telegram/purchase_create_stars_response.py">PurchaseCreateStarsResponse</a></code>
-- <code title="get /v1/telegram/purchases/premium">client.telegram.purchases.<a href="./src/gmt/resources/telegram/purchases.py">list_premium</a>(\*\*<a href="src/gmt/types/telegram/purchase_list_premium_params.py">params</a>) -> <a href="./src/gmt/types/telegram/purchase_list_premium_response.py">SyncPageNumber[PurchaseListPremiumResponse]</a></code>
-- <code title="get /v1/telegram/purchases/stars">client.telegram.purchases.<a href="./src/gmt/resources/telegram/purchases.py">list_stars</a>(\*\*<a href="src/gmt/types/telegram/purchase_list_stars_params.py">params</a>) -> <a href="./src/gmt/types/telegram/purchase_list_stars_response.py">SyncPageNumber[PurchaseListStarsResponse]</a></code>
-
 # Webhooks
 
 Types:

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gmt-python-sdk"
-version = "0.42.0"
+version = "0.43.0"
 description = "The official Python library for the gmt API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/_client.py

@@ -35,13 +35,12 @@ from ._base_client import (
 )
 
 if TYPE_CHECKING:
-    from .resources import profile, service, accounts, telegram, webhooks, purchases, purchases_by_hash
+    from .resources import profile, service, accounts, webhooks, purchases, purchases_by_hash
     from .resources.service import ServiceResource, AsyncServiceResource
     from .resources.accounts import AccountsResource, AsyncAccountsResource
     from .resources.webhooks import WebhooksResource, AsyncWebhooksResource
     from .resources.profile.profile import ProfileResource, AsyncProfileResource
     from .resources.purchases_by_hash import PurchasesByHashResource, AsyncPurchasesByHashResource
-    from .resources.telegram.telegram import TelegramResource, AsyncTelegramResource
     from .resources.purchases.purchases import PurchasesResource, AsyncPurchasesResource
 
 __all__ = ["Timeout", "Transport", "ProxiesTypes", "RequestOptions", "Gmt", "AsyncGmt", "Client", "AsyncClient"]
@@ -145,17 +144,13 @@ class Gmt(SyncAPIClient):
 
     @cached_property
     def purchases_by_hash(self) -> PurchasesByHashResource:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import PurchasesByHashResource
 
         return PurchasesByHashResource(self)
 
-    @cached_property
-    def telegram(self) -> TelegramResource:
-        from .resources.telegram import TelegramResource
-
-        return TelegramResource(self)
-
     @cached_property
     def webhooks(self) -> WebhooksResource:
         """Webhook testing and documentation.
@@ -400,17 +395,13 @@ class AsyncGmt(AsyncAPIClient):
 
     @cached_property
     def purchases_by_hash(self) -> AsyncPurchasesByHashResource:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import AsyncPurchasesByHashResource
 
         return AsyncPurchasesByHashResource(self)
 
-    @cached_property
-    def telegram(self) -> AsyncTelegramResource:
-        from .resources.telegram import AsyncTelegramResource
-
-        return AsyncTelegramResource(self)
-
     @cached_property
     def webhooks(self) -> AsyncWebhooksResource:
         """Webhook testing and documentation.
@@ -601,17 +592,13 @@ class GmtWithRawResponse:
 
     @cached_property
     def purchases_by_hash(self) -> purchases_by_hash.PurchasesByHashResourceWithRawResponse:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import PurchasesByHashResourceWithRawResponse
 
         return PurchasesByHashResourceWithRawResponse(self._client.purchases_by_hash)
 
-    @cached_property
-    def telegram(self) -> telegram.TelegramResourceWithRawResponse:
-        from .resources.telegram import TelegramResourceWithRawResponse
-
-        return TelegramResourceWithRawResponse(self._client.telegram)
-
     @cached_property
     def webhooks(self) -> webhooks.WebhooksResourceWithRawResponse:
         """Webhook testing and documentation.
@@ -688,17 +675,13 @@ class AsyncGmtWithRawResponse:
 
     @cached_property
     def purchases_by_hash(self) -> purchases_by_hash.AsyncPurchasesByHashResourceWithRawResponse:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import AsyncPurchasesByHashResourceWithRawResponse
 
         return AsyncPurchasesByHashResourceWithRawResponse(self._client.purchases_by_hash)
 
-    @cached_property
-    def telegram(self) -> telegram.AsyncTelegramResourceWithRawResponse:
-        from .resources.telegram import AsyncTelegramResourceWithRawResponse
-
-        return AsyncTelegramResourceWithRawResponse(self._client.telegram)
-
     @cached_property
     def webhooks(self) -> webhooks.AsyncWebhooksResourceWithRawResponse:
         """Webhook testing and documentation.
@@ -775,17 +758,13 @@ class GmtWithStreamedResponse:
 
     @cached_property
     def purchases_by_hash(self) -> purchases_by_hash.PurchasesByHashResourceWithStreamingResponse:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import PurchasesByHashResourceWithStreamingResponse
 
         return PurchasesByHashResourceWithStreamingResponse(self._client.purchases_by_hash)
 
-    @cached_property
-    def telegram(self) -> telegram.TelegramResourceWithStreamingResponse:
-        from .resources.telegram import TelegramResourceWithStreamingResponse
-
-        return TelegramResourceWithStreamingResponse(self._client.telegram)
-
     @cached_property
     def webhooks(self) -> webhooks.WebhooksResourceWithStreamingResponse:
         """Webhook testing and documentation.
@@ -862,17 +841,13 @@ class AsyncGmtWithStreamedResponse:
 
     @cached_property
     def purchases_by_hash(self) -> purchases_by_hash.AsyncPurchasesByHashResourceWithStreamingResponse:
-        """Purchase history and management."""
+        """
+        Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+        """
         from .resources.purchases_by_hash import AsyncPurchasesByHashResourceWithStreamingResponse
 
         return AsyncPurchasesByHashResourceWithStreamingResponse(self._client.purchases_by_hash)
 
-    @cached_property
-    def telegram(self) -> telegram.AsyncTelegramResourceWithStreamingResponse:
-        from .resources.telegram import AsyncTelegramResourceWithStreamingResponse
-
-        return AsyncTelegramResourceWithStreamingResponse(self._client.telegram)
-
     @cached_property
     def webhooks(self) -> webhooks.AsyncWebhooksResourceWithStreamingResponse:
         """Webhook testing and documentation.

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "gmt"
-__version__ = "0.42.0"  # x-release-please-version
+__version__ = "0.43.0"  # x-release-please-version

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/resources/__init__.py

@@ -24,14 +24,6 @@ from .accounts import (
     AccountsResourceWithStreamingResponse,
     AsyncAccountsResourceWithStreamingResponse,
 )
-from .telegram import (
-    TelegramResource,
-    AsyncTelegramResource,
-    TelegramResourceWithRawResponse,
-    AsyncTelegramResourceWithRawResponse,
-    TelegramResourceWithStreamingResponse,
-    AsyncTelegramResourceWithStreamingResponse,
-)
 from .webhooks import (
     WebhooksResource,
     AsyncWebhooksResource,
@@ -88,12 +80,6 @@ __all__ = [
     "AsyncPurchasesByHashResourceWithRawResponse",
     "PurchasesByHashResourceWithStreamingResponse",
     "AsyncPurchasesByHashResourceWithStreamingResponse",
-    "TelegramResource",
-    "AsyncTelegramResource",
-    "TelegramResourceWithRawResponse",
-    "AsyncTelegramResourceWithRawResponse",
-    "TelegramResourceWithStreamingResponse",
-    "AsyncTelegramResourceWithStreamingResponse",
     "WebhooksResource",
     "AsyncWebhooksResource",
     "WebhooksResourceWithRawResponse",

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/resources/profile/referral/referral.py

@@ -91,7 +91,8 @@ class ReferralResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ReferralTransferBalanceResponse:
         """
-        Change the current user password to a new one.
+        Transfers a specified amount from the user's referral balance to their main
+        balance. The amount must be between 1 and 100,000 USD.
 
         Args:
           amount: Amount to transfer from referral balance
@@ -175,7 +176,8 @@ class AsyncReferralResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> ReferralTransferBalanceResponse:
         """
-        Change the current user password to a new one.
+        Transfers a specified amount from the user's referral balance to their main
+        balance. The amount must be between 1 and 100,000 USD.
 
         Args:
           amount: Amount to transfer from referral balance

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/resources/purchases/bulk.py

@@ -4,23 +4,15 @@ from __future__ import annotations
 
 import httpx
 
-from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._types import Body, Omit, Query, Headers, NoneType, NotGiven, omit, not_given
 from ..._utils import path_template, maybe_transform, async_maybe_transform
 from ..._compat import cached_property
 from ..._resource import SyncAPIResource, AsyncAPIResource
 from ..._response import (
-    BinaryAPIResponse,
-    AsyncBinaryAPIResponse,
-    StreamedBinaryAPIResponse,
-    AsyncStreamedBinaryAPIResponse,
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
-    to_custom_raw_response_wrapper,
     async_to_streamed_response_wrapper,
-    to_custom_streamed_response_wrapper,
-    async_to_custom_raw_response_wrapper,
-    async_to_custom_streamed_response_wrapper,
 )
 from ..._base_client import make_request_options
 from ...types.purchases import bulk_create_params
@@ -120,7 +112,7 @@ class BulkResource(SyncAPIResource):
 
     def retrieve(
         self,
-        purchase_id: str,
+        purchase_id: int,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -134,6 +126,8 @@ class BulkResource(SyncAPIResource):
         archive.
 
         Args:
+          purchase_id: Unique purchase identifier.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -142,8 +136,6 @@ class BulkResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not purchase_id:
-            raise ValueError(f"Expected a non-empty value for `purchase_id` but received {purchase_id!r}")
         return self._get(
             path_template("/v1/purchases/bulk/{purchase_id}", purchase_id=purchase_id),
             options=make_request_options(
@@ -154,7 +146,7 @@ class BulkResource(SyncAPIResource):
 
     def download(
         self,
-        purchase_id: str,
+        purchase_id: int,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -162,12 +154,14 @@ class BulkResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> BinaryAPIResponse:
+    ) -> None:
         """
         Download the archive file containing multiple accounts from a successful bulk
         purchase
 
         Args:
+          purchase_id: Unique purchase identifier.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -176,15 +170,13 @@ class BulkResource(SyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not purchase_id:
-            raise ValueError(f"Expected a non-empty value for `purchase_id` but received {purchase_id!r}")
-        extra_headers = {"Accept": "application/zip", **(extra_headers or {})}
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return self._get(
             path_template("/v1/purchases/bulk/{purchase_id}/download", purchase_id=purchase_id),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=BinaryAPIResponse,
+            cast_to=NoneType,
         )
 
 
@@ -278,7 +270,7 @@ class AsyncBulkResource(AsyncAPIResource):
 
     async def retrieve(
         self,
-        purchase_id: str,
+        purchase_id: int,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -292,6 +284,8 @@ class AsyncBulkResource(AsyncAPIResource):
         archive.
 
         Args:
+          purchase_id: Unique purchase identifier.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -300,8 +294,6 @@ class AsyncBulkResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not purchase_id:
-            raise ValueError(f"Expected a non-empty value for `purchase_id` but received {purchase_id!r}")
         return await self._get(
             path_template("/v1/purchases/bulk/{purchase_id}", purchase_id=purchase_id),
             options=make_request_options(
@@ -312,7 +304,7 @@ class AsyncBulkResource(AsyncAPIResource):
 
     async def download(
         self,
-        purchase_id: str,
+        purchase_id: int,
         *,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -320,12 +312,14 @@ class AsyncBulkResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> AsyncBinaryAPIResponse:
+    ) -> None:
         """
         Download the archive file containing multiple accounts from a successful bulk
         purchase
 
         Args:
+          purchase_id: Unique purchase identifier.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -334,15 +328,13 @@ class AsyncBulkResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if not purchase_id:
-            raise ValueError(f"Expected a non-empty value for `purchase_id` but received {purchase_id!r}")
-        extra_headers = {"Accept": "application/zip", **(extra_headers or {})}
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
         return await self._get(
             path_template("/v1/purchases/bulk/{purchase_id}/download", purchase_id=purchase_id),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=AsyncBinaryAPIResponse,
+            cast_to=NoneType,
         )
 
 
@@ -356,9 +348,8 @@ class BulkResourceWithRawResponse:
         self.retrieve = to_raw_response_wrapper(
             bulk.retrieve,
         )
-        self.download = to_custom_raw_response_wrapper(
+        self.download = to_raw_response_wrapper(
             bulk.download,
-            BinaryAPIResponse,
         )
 
 
@@ -372,9 +363,8 @@ class AsyncBulkResourceWithRawResponse:
         self.retrieve = async_to_raw_response_wrapper(
             bulk.retrieve,
         )
-        self.download = async_to_custom_raw_response_wrapper(
+        self.download = async_to_raw_response_wrapper(
             bulk.download,
-            AsyncBinaryAPIResponse,
         )
 
 
@@ -388,9 +378,8 @@ class BulkResourceWithStreamingResponse:
         self.retrieve = to_streamed_response_wrapper(
             bulk.retrieve,
         )
-        self.download = to_custom_streamed_response_wrapper(
+        self.download = to_streamed_response_wrapper(
             bulk.download,
-            StreamedBinaryAPIResponse,
         )
 
 
@@ -404,7 +393,6 @@ class AsyncBulkResourceWithStreamingResponse:
         self.retrieve = async_to_streamed_response_wrapper(
             bulk.retrieve,
         )
-        self.download = async_to_custom_streamed_response_wrapper(
+        self.download = async_to_streamed_response_wrapper(
             bulk.download,
-            AsyncStreamedBinaryAPIResponse,
         )

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/resources/purchases_by_hash.py

@@ -23,7 +23,9 @@ __all__ = ["PurchasesByHashResource", "AsyncPurchasesByHashResource"]
 
 
 class PurchasesByHashResource(SyncAPIResource):
-    """Purchase history and management."""
+    """
+    Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+    """
 
     @cached_property
     def with_raw_response(self) -> PurchasesByHashResourceWithRawResponse:
@@ -61,6 +63,10 @@ class PurchasesByHashResource(SyncAPIResource):
 
         **No authentication required.** The hash code serves as the access token.
 
+        **Path parameter `hash`.** If it is missing or empty in the URL (e.g.
+        `/v1/purchases-by-hash/` or `/v1/purchases-by-hash//`), the API returns **400**
+        with `fieldViolations` on `hash`.
+
         Args:
           hash: Unique hash code of the purchase
 
@@ -103,6 +109,10 @@ class PurchasesByHashResource(SyncAPIResource):
         **Idempotent Operation.** Safe to retry on network errors - will not generate
         duplicate codes.
 
+        **Path parameter `hash`.** If it is missing or empty before `/request-code`
+        (e.g. `/v1/purchases-by-hash/request-code`), the API returns **400** with
+        `fieldViolations` on `hash`.
+
         Args:
           hash: Unique hash code of the purchase
 
@@ -137,7 +147,9 @@ class PurchasesByHashResource(SyncAPIResource):
 
 
 class AsyncPurchasesByHashResource(AsyncAPIResource):
-    """Purchase history and management."""
+    """
+    Endpoints for accessing purchase details and requesting verification codes using a unique hash identifier instead of purchase ID. This allows retrieval of purchase information without authentication, using the hash as a secure access token.
+    """
 
     @cached_property
     def with_raw_response(self) -> AsyncPurchasesByHashResourceWithRawResponse:
@@ -175,6 +187,10 @@ class AsyncPurchasesByHashResource(AsyncAPIResource):
 
         **No authentication required.** The hash code serves as the access token.
 
+        **Path parameter `hash`.** If it is missing or empty in the URL (e.g.
+        `/v1/purchases-by-hash/` or `/v1/purchases-by-hash//`), the API returns **400**
+        with `fieldViolations` on `hash`.
+
         Args:
           hash: Unique hash code of the purchase
 
@@ -217,6 +233,10 @@ class AsyncPurchasesByHashResource(AsyncAPIResource):
         **Idempotent Operation.** Safe to retry on network errors - will not generate
         duplicate codes.
 
+        **Path parameter `hash`.** If it is missing or empty before `/request-code`
+        (e.g. `/v1/purchases-by-hash/request-code`), the API returns **400** with
+        `fieldViolations` on `hash`.
+
         Args:
           hash: Unique hash code of the purchase
 

{gmt_python_sdk-0.42.0 → gmt_python_sdk-0.43.0}/src/gmt/types/__init__.py

@@ -21,15 +21,11 @@ from .service_health_check_response import ServiceHealthCheckResponse as Service
 from .profile_change_language_params import ProfileChangeLanguageParams as ProfileChangeLanguageParams
 from .profile_change_password_params import ProfileChangePasswordParams as ProfileChangePasswordParams
 from .account_list_countries_response import AccountListCountriesResponse as AccountListCountriesResponse
-from .telegram_get_stars_price_params import TelegramGetStarsPriceParams as TelegramGetStarsPriceParams
 from .profile_change_language_response import ProfileChangeLanguageResponse as ProfileChangeLanguageResponse
 from .profile_change_password_response import ProfileChangePasswordResponse as ProfileChangePasswordResponse
 from .profile_unbind_telegram_response import ProfileUnbindTelegramResponse as ProfileUnbindTelegramResponse
 from .service_get_server_time_response import ServiceGetServerTimeResponse as ServiceGetServerTimeResponse
-from .telegram_get_premium_price_params import TelegramGetPremiumPriceParams as TelegramGetPremiumPriceParams
-from .telegram_get_stars_price_response import TelegramGetStarsPriceResponse as TelegramGetStarsPriceResponse
 from .purchases_by_hash_retrieve_response import PurchasesByHashRetrieveResponse as PurchasesByHashRetrieveResponse
-from .telegram_get_premium_price_response import TelegramGetPremiumPriceResponse as TelegramGetPremiumPriceResponse
 from .purchase_request_verification_code_params import (
     PurchaseRequestVerificationCodeParams as PurchaseRequestVerificationCodeParams,
 )

gmt_python_sdk-0.43.0/src/gmt/types/telegram/__init__.py

@@ -0,0 +1,3 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations