gmt-python-sdk 0.1.0__py3-none-any.whl

gmt/types/purchase_list_response.py

@@ -0,0 +1,108 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["PurchaseListResponse", "DisplayName", "Price", "Verification"]
+
+
+class DisplayName(BaseModel):
+    en: str
+    """Name in English."""
+
+    ru: str
+    """Name in Russian."""
+
+
+class Price(BaseModel):
+    amount: str
+    """Monetary amount as a string with up to 2 decimal places."""
+
+    currency_code: str
+    """ISO 4217 currency code."""
+
+
+class Verification(BaseModel):
+    code: str
+    """Verification code for account."""
+
+    password: str
+    """Account password."""
+
+    received_at: str
+    """
+    **Code Retrieval Timestamp.** Marks when verification code was successfully
+    fetched from the provider (not when purchase was created).
+
+    **Example timeline.**
+
+    - `created_at`: `2024-11-19T10:00:00Z` (purchase created)
+    - `received_at`: `2024-11-19T10:05:02Z` (code requested 5 minutes later)
+
+    **Note.** These timestamps may be identical if code is requested immediately
+    after purchase.
+    """
+
+
+class PurchaseListResponse(BaseModel):
+    id: int
+    """Unique purchase identifier."""
+
+    country_code: str
+    """ISO 3166-1 alpha-2 country code."""
+
+    created_at: str
+    """Purchase creation time in ISO 8601 format (UTC)."""
+
+    display_name: DisplayName
+
+    phone_number: str
+    """
+    **E.164 International Format.** Phone number with country code prefix (e.g.,
+    `+12025550123` for US, `+79991234567` for Russia).
+
+    **Usage.** This is your Telegram account login. Use it with `verification.code`
+    and `verification.password` to access the account.
+    """
+
+    price: Price
+    """
+    **Final Price After Discount.** The actual amount deducted from your balance,
+    with your personal discount already applied.
+
+    **To see pricing breakdown before purchase.** Check
+    `GET /accounts/:country_code` which shows both discounted price and original
+    `base_price`.
+
+    **Discount eligibility.** Based on your total successful purchase count. Higher
+    volume = bigger discounts.
+    """
+
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    """
+    **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
+    request) or `ERROR` (provider failure). Any status can transition to `REFUND`
+    via admin action.
+
+    **Important.** Status is immutable once set to `SUCCESS`, `ERROR`, or `REFUND`.
+
+    **Filter options**
+
+    - `PENDING` - code not requested.
+    - `SUCCESS` - code ready.
+    - `ERROR` - provider failed.
+    - `REFUND` - money returned.
+    """
+
+    verification: Optional[Verification] = None
+    """
+    **Verification Credentials.** Login credentials for the purchased Telegram
+    account. Initially `null` after purchase creation.
+
+    **Availability.** Populated after calling `POST /purchases/:id/request-code`.
+    Once received, credentials are permanent and cannot be re-requested.
+
+    **Security.** Verification data is only visible to the purchase owner.
+    """

gmt/types/purchase_request_verification_code_response.py

@@ -0,0 +1,108 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["PurchaseRequestVerificationCodeResponse", "DisplayName", "Price", "Verification"]
+
+
+class DisplayName(BaseModel):
+    en: str
+    """Name in English."""
+
+    ru: str
+    """Name in Russian."""
+
+
+class Price(BaseModel):
+    amount: str
+    """Monetary amount as a string with up to 2 decimal places."""
+
+    currency_code: str
+    """ISO 4217 currency code."""
+
+
+class Verification(BaseModel):
+    code: str
+    """Verification code for account."""
+
+    password: str
+    """Account password."""
+
+    received_at: str
+    """
+    **Code Retrieval Timestamp.** Marks when verification code was successfully
+    fetched from the provider (not when purchase was created).
+
+    **Example timeline.**
+
+    - `created_at`: `2024-11-19T10:00:00Z` (purchase created)
+    - `received_at`: `2024-11-19T10:05:02Z` (code requested 5 minutes later)
+
+    **Note.** These timestamps may be identical if code is requested immediately
+    after purchase.
+    """
+
+
+class PurchaseRequestVerificationCodeResponse(BaseModel):
+    id: int
+    """Unique purchase identifier."""
+
+    country_code: str
+    """ISO 3166-1 alpha-2 country code."""
+
+    created_at: str
+    """Purchase creation time in ISO 8601 format (UTC)."""
+
+    display_name: DisplayName
+
+    phone_number: str
+    """
+    **E.164 International Format.** Phone number with country code prefix (e.g.,
+    `+12025550123` for US, `+79991234567` for Russia).
+
+    **Usage.** This is your Telegram account login. Use it with `verification.code`
+    and `verification.password` to access the account.
+    """
+
+    price: Price
+    """
+    **Final Price After Discount.** The actual amount deducted from your balance,
+    with your personal discount already applied.
+
+    **To see pricing breakdown before purchase.** Check
+    `GET /accounts/:country_code` which shows both discounted price and original
+    `base_price`.
+
+    **Discount eligibility.** Based on your total successful purchase count. Higher
+    volume = bigger discounts.
+    """
+
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    """
+    **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
+    request) or `ERROR` (provider failure). Any status can transition to `REFUND`
+    via admin action.
+
+    **Important.** Status is immutable once set to `SUCCESS`, `ERROR`, or `REFUND`.
+
+    **Filter options**
+
+    - `PENDING` - code not requested.
+    - `SUCCESS` - code ready.
+    - `ERROR` - provider failed.
+    - `REFUND` - money returned.
+    """
+
+    verification: Optional[Verification] = None
+    """
+    **Verification Credentials.** Login credentials for the purchased Telegram
+    account. Initially `null` after purchase creation.
+
+    **Availability.** Populated after calling `POST /purchases/:id/request-code`.
+    Once received, credentials are permanent and cannot be re-requested.
+
+    **Security.** Verification data is only visible to the purchase owner.
+    """

gmt/types/purchase_retrieve_response.py

@@ -0,0 +1,108 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["PurchaseRetrieveResponse", "DisplayName", "Price", "Verification"]
+
+
+class DisplayName(BaseModel):
+    en: str
+    """Name in English."""
+
+    ru: str
+    """Name in Russian."""
+
+
+class Price(BaseModel):
+    amount: str
+    """Monetary amount as a string with up to 2 decimal places."""
+
+    currency_code: str
+    """ISO 4217 currency code."""
+
+
+class Verification(BaseModel):
+    code: str
+    """Verification code for account."""
+
+    password: str
+    """Account password."""
+
+    received_at: str
+    """
+    **Code Retrieval Timestamp.** Marks when verification code was successfully
+    fetched from the provider (not when purchase was created).
+
+    **Example timeline.**
+
+    - `created_at`: `2024-11-19T10:00:00Z` (purchase created)
+    - `received_at`: `2024-11-19T10:05:02Z` (code requested 5 minutes later)
+
+    **Note.** These timestamps may be identical if code is requested immediately
+    after purchase.
+    """
+
+
+class PurchaseRetrieveResponse(BaseModel):
+    id: int
+    """Unique purchase identifier."""
+
+    country_code: str
+    """ISO 3166-1 alpha-2 country code."""
+
+    created_at: str
+    """Purchase creation time in ISO 8601 format (UTC)."""
+
+    display_name: DisplayName
+
+    phone_number: str
+    """
+    **E.164 International Format.** Phone number with country code prefix (e.g.,
+    `+12025550123` for US, `+79991234567` for Russia).
+
+    **Usage.** This is your Telegram account login. Use it with `verification.code`
+    and `verification.password` to access the account.
+    """
+
+    price: Price
+    """
+    **Final Price After Discount.** The actual amount deducted from your balance,
+    with your personal discount already applied.
+
+    **To see pricing breakdown before purchase.** Check
+    `GET /accounts/:country_code` which shows both discounted price and original
+    `base_price`.
+
+    **Discount eligibility.** Based on your total successful purchase count. Higher
+    volume = bigger discounts.
+    """
+
+    status: Literal["PENDING", "SUCCESS", "ERROR", "REFUND"]
+    """
+    **Purchase Status Lifecycle.** `PENDING` (initial) → `SUCCESS` (after code
+    request) or `ERROR` (provider failure). Any status can transition to `REFUND`
+    via admin action.
+
+    **Important.** Status is immutable once set to `SUCCESS`, `ERROR`, or `REFUND`.
+
+    **Filter options**
+
+    - `PENDING` - code not requested.
+    - `SUCCESS` - code ready.
+    - `ERROR` - provider failed.
+    - `REFUND` - money returned.
+    """
+
+    verification: Optional[Verification] = None
+    """
+    **Verification Credentials.** Login credentials for the purchased Telegram
+    account. Initially `null` after purchase creation.
+
+    **Availability.** Populated after calling `POST /purchases/:id/request-code`.
+    Once received, credentials are permanent and cannot be re-requested.
+
+    **Security.** Verification data is only visible to the purchase owner.
+    """

gmt/types/service_get_server_time_response.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["ServiceGetServerTimeResponse"]
+
+
+class ServiceGetServerTimeResponse(BaseModel):
+    epoch_ms: int = FieldInfo(alias="epochMs")
+    """Current server time in milliseconds since Unix epoch."""
+
+    iso: str
+    """Current server time in ISO 8601 format."""
+
+    timezone: str
+    """Server timezone."""

gmt/types/service_health_check_response.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["ServiceHealthCheckResponse", "Checks"]
+
+
+class Checks(BaseModel):
+    database: bool
+    """Database connection status."""
+
+    redis: bool
+    """Redis connection status."""
+
+
+class ServiceHealthCheckResponse(BaseModel):
+    now: str
+    """Current server time in ISO 8601 format."""
+
+    status: Literal["ok", "degraded"]
+    """Service status."""
+
+    uptime_seconds: int = FieldInfo(alias="uptimeSeconds")
+    """API uptime in seconds."""
+
+    checks: Optional[Checks] = None
+    """Detailed information about dependencies state."""