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.2.1b29

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.2.1b29
File	Size	Uploaded	Provenance	Actions
nextx_sdk-0.2.1b29.tar.gz	236.9 kB	Oct 30, 2026	With provenance	Details for nextx_sdk-0.2.1b29.tar.gz

Built distribution (wheel)

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

Total release size: 763.7 kB

Release files / nextx_sdk-0.2.1b29.tar.gz

Download URL	nextx_sdk-0.2.1b29.tar.gz
Size	236.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`f8538f5eb9c6b10740f13f79a203fdd7ffd568ac26466fb653a4945bacf82da7`
BLAKE2b-256 checksum How to use checksums	`b8368c9540096eadb886930bb0a75b792ca0a03a751120a0553e23b589c2e83f`
Upload date	Oct 30, 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/7a3cec6125d26ac79af31020dd833bb2a5077d0c

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/7a3cec6125d26ac79af31020dd833bb2a5077d0c/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/41144235044/attempts/1

Artifact

Subject: nextx_sdk-0.2.1b29.tar.gz
SHA-256 checksum: f8538f5eb9c6b10740f13f79a203fdd7ffd568ac26466fb653a4945bacf82da7 Verifying attestations

Release files / nextx_sdk-0.2.1b29-py3-none-any.whl

Download URL	nextx_sdk-0.2.1b29-py3-none-any.whl
Size	526.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0711cb37025496fb76ab30b7291f703aaaa73a79cc3be2f9e5ab4d63e1f6cd84`
BLAKE2b-256 checksum How to use checksums	`542dd4588cab4872185d58bfced97d9f0a0fc6f148ef3e43900d7b355dfd0d51`
Upload date	Oct 30, 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/7a3cec6125d26ac79af31020dd833bb2a5077d0c

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/7a3cec6125d26ac79af31020dd833bb2a5077d0c/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/41144235044/attempts/1

Artifact

Subject: nextx_sdk-0.2.1b29-py3-none-any.whl
SHA-256 checksum: 0711cb37025496fb76ab30b7291f703aaaa73a79cc3be2f9e5ab4d63e1f6cd84 Verifying attestations

Security for nextx-sdk 0.2.1b29

Report project as malware

Provenance

Full provenance

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

Attestation for nextx_sdk-0.2.1b29.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/7a3cec6125d26ac79af31020dd833bb2a5077d0c

Workflow

Publishing configuration: github.com/nextx-organization/nextx-sdk-python/blob/7a3cec6125d26ac79af31020dd833bb2a5077d0c/.github/workflows/release.yml
Publishing logs: github.com/nextx-organization/nextx-sdk-python/actions/runs/41144235044/attempts/1

Artifact

Subject: nextx_sdk-0.2.1b29.tar.gz
SHA-256 checksum: f8538f5eb9c6b10740f13f79a203fdd7ffd568ac26466fb653a4945bacf82da7 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.