nextx-sdk 0.1.0b3__tar.gz

nextx_sdk-0.1.0b3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NextX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nextx_sdk-0.1.0b3/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.1
+Name: nextx-sdk
+Version: 0.1.0b3
+Summary: NextX API cho Python — sinh từ OpenAPI công khai, có kiểu đầy đủ
+Keywords: nextx,crm,sales,api,sdk,openapi
+Author-Email: NextX <support@nextx.vn>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Project-URL: Homepage, https://developers.nextx.vn/docs/sdk
+Project-URL: Documentation, https://developers.nextx.vn
+Project-URL: Source, https://github.com/nextx-organization/nextx-sdk-python
+Project-URL: Changelog, https://github.com/nextx-organization/nextx-sdk-python/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/nextx-organization/nextx-sdk-python/issues
+Requires-Python: >=3.11
+Requires-Dist: httpx<0.29.0,>=0.23.1
+Requires-Dist: attrs>=22.2.0
+Description-Content-Type: text/markdown
+
+# nextx-sdk
+
+> Mã trong kho này được sinh tự động từ [OpenAPI công khai](https://developers.nextx.vn/openapi.json). Đừng sửa tay — xem [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Gọi NextX API từ Python, có kiểu đầy đủ (đồng bộ và `async`). Mã sinh từ [`/openapi.json`](https://developers.nextx.vn/openapi.json)
+và chỉ gồm các tuyến đối tác gọi được.
+
+```sh
+pip install nextx-sdk
+```
+
+```python
+import os
+from nextx_sdk import create_client, SANDBOX_URL
+from nextx_sdk.api.crm import contacts_list
+
+# Khoá API của workspace (tạo trong phần mềm NextX) — gửi ở header X-Api-Key
+nx = create_client(api_key=os.environ["NEXTX_API_KEY"], base_url=SANDBOX_URL)
+
+page = contacts_list.sync(client=nx, page_size=20)
+for c in page.items or []:
+    print(c.full_name)
+
+# async
+page = await contacts_list.asyncio(client=nx, page_size=20)
+```
+
+Ứng dụng đối tác dùng OAuth 2.0: `create_client(access_token=token)` (gửi `Authorization: Bearer`).
+
+- Python ≥ 3.11. Mỗi thao tác là một mô-đun trong `nextx_sdk.api.<phân hệ>` với 4 hàm: `sync`, `sync_detailed`, `asyncio`, `asyncio_detailed`.
+  Bản `*_detailed` trả thêm mã trạng thái và header.
+- Mặc định gọi prod (`PROD_URL`). Thử nghiệm thì dùng `SANDBOX_URL` với khoá sandbox.
+- Mã trạng thái ngoài tài liệu ném `nextx_sdk.errors.UnexpectedStatus`.
+
+Tài liệu: https://developers.nextx.vn/docs/sdk · Phiên bản và bỏ dần: [VERSIONING.md](https://github.com/nextx-organization/nextx-sdk-python/blob/main/VERSIONING.md) · Giấy phép MIT

nextx_sdk-0.1.0b3/README.md

@@ -0,0 +1,35 @@
+# nextx-sdk
+
+> Mã trong kho này được sinh tự động từ [OpenAPI công khai](https://developers.nextx.vn/openapi.json). Đừng sửa tay — xem [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Gọi NextX API từ Python, có kiểu đầy đủ (đồng bộ và `async`). Mã sinh từ [`/openapi.json`](https://developers.nextx.vn/openapi.json)
+và chỉ gồm các tuyến đối tác gọi được.
+
+```sh
+pip install nextx-sdk
+```
+
+```python
+import os
+from nextx_sdk import create_client, SANDBOX_URL
+from nextx_sdk.api.crm import contacts_list
+
+# Khoá API của workspace (tạo trong phần mềm NextX) — gửi ở header X-Api-Key
+nx = create_client(api_key=os.environ["NEXTX_API_KEY"], base_url=SANDBOX_URL)
+
+page = contacts_list.sync(client=nx, page_size=20)
+for c in page.items or []:
+    print(c.full_name)
+
+# async
+page = await contacts_list.asyncio(client=nx, page_size=20)
+```
+
+Ứng dụng đối tác dùng OAuth 2.0: `create_client(access_token=token)` (gửi `Authorization: Bearer`).
+
+- Python ≥ 3.11. Mỗi thao tác là một mô-đun trong `nextx_sdk.api.<phân hệ>` với 4 hàm: `sync`, `sync_detailed`, `asyncio`, `asyncio_detailed`.
+  Bản `*_detailed` trả thêm mã trạng thái và header.
+- Mặc định gọi prod (`PROD_URL`). Thử nghiệm thì dùng `SANDBOX_URL` với khoá sandbox.
+- Mã trạng thái ngoài tài liệu ném `nextx_sdk.errors.UnexpectedStatus`.
+
+Tài liệu: https://developers.nextx.vn/docs/sdk · Phiên bản và bỏ dần: [VERSIONING.md](https://github.com/nextx-organization/nextx-sdk-python/blob/main/VERSIONING.md) · Giấy phép MIT

nextx_sdk-0.1.0b3/nextx_sdk/__init__.py

@@ -0,0 +1,13 @@
+
+""" A client library for accessing NextX Open Platform API """
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)
+
+from ._version import VERSION
+from .nextx import PROD_URL, SANDBOX_URL, create_client
+
+__all__ = (*__all__, "VERSION", "PROD_URL", "SANDBOX_URL", "create_client")

nextx_sdk-0.1.0b3/nextx_sdk/_version.py

@@ -0,0 +1 @@
+VERSION = "0.1.0b3"

nextx_sdk-0.1.0b3/nextx_sdk/api/__init__.py

@@ -0,0 +1 @@
+""" Contains methods for accessing the API """

nextx_sdk-0.1.0b3/nextx_sdk/api/call/__init__.py

@@ -0,0 +1 @@
+""" Contains endpoint functions for accessing the API """

nextx_sdk-0.1.0b3/nextx_sdk/api/call/agents_list.py

@@ -0,0 +1,277 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.agent_list_result import AgentListResult
+from ...models.agents_list_status import AgentsListStatus
+from ...models.agents_list_status import check_agents_list_status
+from ...types import UNSET, Unset
+from typing import cast
+from uuid import UUID
+
+
+
+def _get_kwargs(
+    *,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+    status: AgentsListStatus | Unset = UNSET,
+    queue_id: UUID | Unset = UNSET,
+    is_active: bool | Unset = UNSET,
+    search: str | Unset = UNSET,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    params: dict[str, Any] = {}
+
+    params["pageNumber"] = page_number
+
+    params["pageSize"] = page_size
+
+    json_status: str | Unset = UNSET
+    if not isinstance(status, Unset):
+        json_status = status
+
+    params["status"] = json_status
+
+    json_queue_id: str | Unset = UNSET
+    if not isinstance(queue_id, Unset):
+        json_queue_id = str(queue_id)
+    params["queueId"] = json_queue_id
+
+    params["isActive"] = is_active
+
+    params["search"] = search
+
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/call/agents",
+        "params": params,
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> AgentListResult | None:
+    if response.status_code == 200:
+        response_200 = AgentListResult.from_dict(response.json())
+
+
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[AgentListResult]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+    status: AgentsListStatus | Unset = UNSET,
+    queue_id: UUID | Unset = UNSET,
+    is_active: bool | Unset = UNSET,
+    search: str | Unset = UNSET,
+
+) -> Response[AgentListResult]:
+    """ Danh sách agents
+
+     Danh sách có phân trang, kèm trạng thái trực tuyến hiện tại của từng agent. sip_password không trả
+    về.
+
+    Args:
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+        status (AgentsListStatus | Unset):
+        queue_id (UUID | Unset):
+        is_active (bool | Unset):
+        search (str | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentListResult]
+     """
+
+
+    kwargs = _get_kwargs(
+        page_number=page_number,
+page_size=page_size,
+status=status,
+queue_id=queue_id,
+is_active=is_active,
+search=search,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+    status: AgentsListStatus | Unset = UNSET,
+    queue_id: UUID | Unset = UNSET,
+    is_active: bool | Unset = UNSET,
+    search: str | Unset = UNSET,
+
+) -> AgentListResult | None:
+    """ Danh sách agents
+
+     Danh sách có phân trang, kèm trạng thái trực tuyến hiện tại của từng agent. sip_password không trả
+    về.
+
+    Args:
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+        status (AgentsListStatus | Unset):
+        queue_id (UUID | Unset):
+        is_active (bool | Unset):
+        search (str | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentListResult
+     """
+
+
+    return sync_detailed(
+        client=client,
+page_number=page_number,
+page_size=page_size,
+status=status,
+queue_id=queue_id,
+is_active=is_active,
+search=search,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+    status: AgentsListStatus | Unset = UNSET,
+    queue_id: UUID | Unset = UNSET,
+    is_active: bool | Unset = UNSET,
+    search: str | Unset = UNSET,
+
+) -> Response[AgentListResult]:
+    """ Danh sách agents
+
+     Danh sách có phân trang, kèm trạng thái trực tuyến hiện tại của từng agent. sip_password không trả
+    về.
+
+    Args:
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+        status (AgentsListStatus | Unset):
+        queue_id (UUID | Unset):
+        is_active (bool | Unset):
+        search (str | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[AgentListResult]
+     """
+
+
+    kwargs = _get_kwargs(
+        page_number=page_number,
+page_size=page_size,
+status=status,
+queue_id=queue_id,
+is_active=is_active,
+search=search,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+    status: AgentsListStatus | Unset = UNSET,
+    queue_id: UUID | Unset = UNSET,
+    is_active: bool | Unset = UNSET,
+    search: str | Unset = UNSET,
+
+) -> AgentListResult | None:
+    """ Danh sách agents
+
+     Danh sách có phân trang, kèm trạng thái trực tuyến hiện tại của từng agent. sip_password không trả
+    về.
+
+    Args:
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+        status (AgentsListStatus | Unset):
+        queue_id (UUID | Unset):
+        is_active (bool | Unset):
+        search (str | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        AgentListResult
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+page_number=page_number,
+page_size=page_size,
+status=status,
+queue_id=queue_id,
+is_active=is_active,
+search=search,
+
+    )).parsed

nextx_sdk-0.1.0b3/nextx_sdk/api/call/call_flows_list.py

@@ -0,0 +1,248 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.call_flow_list_result import CallFlowListResult
+from ...types import UNSET, Unset
+from typing import cast
+
+
+
+def _get_kwargs(
+    *,
+    status: str | Unset = UNSET,
+    trigger_type: str | Unset = UNSET,
+    search: str | Unset = UNSET,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    params: dict[str, Any] = {}
+
+    params["status"] = status
+
+    params["triggerType"] = trigger_type
+
+    params["search"] = search
+
+    params["pageNumber"] = page_number
+
+    params["pageSize"] = page_size
+
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/call/call-flows",
+        "params": params,
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> CallFlowListResult | None:
+    if response.status_code == 200:
+        response_200 = CallFlowListResult.from_dict(response.json())
+
+
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[CallFlowListResult]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    status: str | Unset = UNSET,
+    trigger_type: str | Unset = UNSET,
+    search: str | Unset = UNSET,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+
+) -> Response[CallFlowListResult]:
+    """ Danh sách call flows
+
+     PagedResult với triggerType filter.
+
+    Args:
+        status (str | Unset):
+        trigger_type (str | Unset):
+        search (str | Unset):
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CallFlowListResult]
+     """
+
+
+    kwargs = _get_kwargs(
+        status=status,
+trigger_type=trigger_type,
+search=search,
+page_number=page_number,
+page_size=page_size,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    status: str | Unset = UNSET,
+    trigger_type: str | Unset = UNSET,
+    search: str | Unset = UNSET,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+
+) -> CallFlowListResult | None:
+    """ Danh sách call flows
+
+     PagedResult với triggerType filter.
+
+    Args:
+        status (str | Unset):
+        trigger_type (str | Unset):
+        search (str | Unset):
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CallFlowListResult
+     """
+
+
+    return sync_detailed(
+        client=client,
+status=status,
+trigger_type=trigger_type,
+search=search,
+page_number=page_number,
+page_size=page_size,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    status: str | Unset = UNSET,
+    trigger_type: str | Unset = UNSET,
+    search: str | Unset = UNSET,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+
+) -> Response[CallFlowListResult]:
+    """ Danh sách call flows
+
+     PagedResult với triggerType filter.
+
+    Args:
+        status (str | Unset):
+        trigger_type (str | Unset):
+        search (str | Unset):
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[CallFlowListResult]
+     """
+
+
+    kwargs = _get_kwargs(
+        status=status,
+trigger_type=trigger_type,
+search=search,
+page_number=page_number,
+page_size=page_size,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    status: str | Unset = UNSET,
+    trigger_type: str | Unset = UNSET,
+    search: str | Unset = UNSET,
+    page_number: int | Unset = 1,
+    page_size: int | Unset = 20,
+
+) -> CallFlowListResult | None:
+    """ Danh sách call flows
+
+     PagedResult với triggerType filter.
+
+    Args:
+        status (str | Unset):
+        trigger_type (str | Unset):
+        search (str | Unset):
+        page_number (int | Unset):  Default: 1.
+        page_size (int | Unset):  Default: 20.
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        CallFlowListResult
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+status=status,
+trigger_type=trigger_type,
+search=search,
+page_number=page_number,
+page_size=page_size,
+
+    )).parsed