Pre-release

This release is a pre-release and may not be stable for production use.

nextx-sdk

Thư viện chính thức để gọi NextX API từ Python, hỗ trợ cả đồng bộ và async.

Mã trong kho này được sinh tự động từ OpenAPI của NextX. Vui lòng không sửa trực tiếp, xem CONTRIBUTING.md.

Cài đặt

pip install nextx-sdk

Yêu cầu Python 3.11 trở lên.

Bắt đầu

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 thì tạo client bằng create_client(access_token=token).

Ghi chú

Mỗi endpoint là một mô-đun trong nextx_sdk.api.<phân hệ> với 4 hàm: sync, sync_detailed, asyncio, asyncio_detailed. Các hàm *_detailed trả thêm mã trạng thái và header.
Mặc định client gọi môi trường production (PROD_URL). Khi thử nghiệm, dùng SANDBOX_URL với khoá sandbox.
Mã trạng thái không có trong tài liệu sẽ ném nextx_sdk.errors.UnexpectedStatus.

Tài liệu

Hướng dẫn: https://developers.nextx.vn/docs/sdk
Phiên bản và chính sách ngừng hỗ trợ: VERSIONING.md
Nhật ký thay đổi: CHANGELOG.md

Giấy phép MIT.

Metadata

Release files for nextx-sdk 0.1.2b19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nextx-sdk 0.1.2b19
File	Size	Uploaded	Provenance	Actions
nextx_sdk-0.1.2b19.tar.gz	228.4 kB	Oct 29, 2026	With provenance	Details for nextx_sdk-0.1.2b19.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nextx-sdk 0.1.2b19
File	Interpreter	ABI	Platform	Actions Reset
nextx_sdk-0.1.2b19-py3-none-any.whl 498.7 kB Oct 29, 2026 With provenance	Python 3	none	any	Details for nextx_sdk-0.1.2b19-py3-none-any.whl

Total release size: 727.1 kB

Release files / nextx_sdk-0.1.2b19.tar.gz

Download URL	nextx_sdk-0.1.2b19.tar.gz
Size	228.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`5fb54ea243bca9102632e2f72724bdba8715ef54009f1791146c7ecf36bce2e0`
BLAKE2b-256 checksum How to use checksums	`5b225f0234068a16c0f0aa2b5f1fcffe738a580ae1c68dc37624694ccde1b012`
Upload date	Oct 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nextx-organization/nextx-sdk-python
Publishing commit: github.com/nextx-organization/nextx-sdk-python/tree/267e914ab982a116af9002c26d308f34718383dd

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/267e914ab982a116af9002c26d308f34718383dd/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/40929853638/attempts/1

Artifact

Subject: nextx_sdk-0.1.2b19.tar.gz
SHA-256 checksum: 5fb54ea243bca9102632e2f72724bdba8715ef54009f1791146c7ecf36bce2e0 Verifying attestations

Release files / nextx_sdk-0.1.2b19-py3-none-any.whl

Download URL	nextx_sdk-0.1.2b19-py3-none-any.whl
Size	498.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f75efe06993c862a10dd9e1cd50bf6164ba44922e162270bc68d17ca675834bb`
BLAKE2b-256 checksum How to use checksums	`2272c972b253882f4b50781289dcc486d2b9d291f4f43cb71b5aae5e9f4c76be`
Upload date	Oct 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.12.9`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nextx-organization/nextx-sdk-python
Publishing commit: github.com/nextx-organization/nextx-sdk-python/tree/267e914ab982a116af9002c26d308f34718383dd

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/267e914ab982a116af9002c26d308f34718383dd/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/40929853638/attempts/1

Artifact

Subject: nextx_sdk-0.1.2b19-py3-none-any.whl
SHA-256 checksum: f75efe06993c862a10dd9e1cd50bf6164ba44922e162270bc68d17ca675834bb Verifying attestations

Security for nextx-sdk 0.1.2b19

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for nextx_sdk-0.1.2b19.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nextx-organization/nextx-sdk-python
Publishing commit: github.com/nextx-organization/nextx-sdk-python/tree/267e914ab982a116af9002c26d308f34718383dd

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/267e914ab982a116af9002c26d308f34718383dd/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/40929853638/attempts/1

Artifact

Subject: nextx_sdk-0.1.2b19.tar.gz
SHA-256 checksum: 5fb54ea243bca9102632e2f72724bdba8715ef54009f1791146c7ecf36bce2e0 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.