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.0

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.0
File	Size	Uploaded	Provenance	Actions
nextx_sdk-0.2.0.tar.gz	228.3 kB	Oct 30, 2026	With provenance	Details for nextx_sdk-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 727.0 kB

Release files / nextx_sdk-0.2.0.tar.gz

Download URL	nextx_sdk-0.2.0.tar.gz
Size	228.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`647a8dfc9f4c9abd85238c710bb356307abfb579796a5312bf8f015061f4e068`
BLAKE2b-256 checksum How to use checksums	`e95244b434e10097d39cbc2546034b6a96fd4766ad3eb2156b998f84edeaf77e`
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/b9a6b2621b8f8f2beac1ff9cd03d28113beb17f9

Workflow

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

Artifact

Subject: nextx_sdk-0.2.0.tar.gz
SHA-256 checksum: 647a8dfc9f4c9abd85238c710bb356307abfb579796a5312bf8f015061f4e068 Verifying attestations

Release files / nextx_sdk-0.2.0-py3-none-any.whl

Download URL	nextx_sdk-0.2.0-py3-none-any.whl
Size	498.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4a4b8997a82814c41594e7249097433c36a0cce5309c4c00e2be9b0504a27186`
BLAKE2b-256 checksum How to use checksums	`86b288001e11a72278feac759f5d1c1e961a1baec4bd9a848d7f1e26b9b47c35`
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/b9a6b2621b8f8f2beac1ff9cd03d28113beb17f9

Workflow

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

Artifact

Subject: nextx_sdk-0.2.0-py3-none-any.whl
SHA-256 checksum: 4a4b8997a82814c41594e7249097433c36a0cce5309c4c00e2be9b0504a27186 Verifying attestations

Security for nextx-sdk 0.2.0

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.0.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/b9a6b2621b8f8f2beac1ff9cd03d28113beb17f9

Workflow

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

Artifact

Subject: nextx_sdk-0.2.0.tar.gz
SHA-256 checksum: 647a8dfc9f4c9abd85238c710bb356307abfb579796a5312bf8f015061f4e068 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.