Pre-release

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

nextfarm-sdk

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

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

Cài đặt

pip install nextfarm-sdk

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

Bắt đầu

import os
from nextfarm_sdk import create_client, SANDBOX_URL
from nextfarm_sdk.api.iot import get_api_v1_iot_devices

nf = create_client(api_key=os.environ["NEXTFARM_API_KEY"], base_url=SANDBOX_URL)

page = get_api_v1_iot_devices.sync(client=nf, page=1, page_size=20)
for d in page.items or []:
    print(d.name)

# async
page = await get_api_v1_iot_devices.asyncio(client=nf, page=1)

Ghi chú

Mỗi endpoint là một module trong nextfarm_sdk.api.<nhóm>, gồm bốn hàm sync, sync_detailed, asyncio và 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. 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 nextfarm_sdk.errors.UnexpectedStatus.

Tài liệu

Hướng dẫn: https://developers.nextfarm.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 nextfarm-sdk 0.1.3b24

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

Source distribution (sdist)

Source distribution for nextfarm-sdk 0.1.3b24
File	Size	Uploaded	Provenance	Actions
nextfarm_sdk-0.1.3b24.tar.gz	561.9 kB	Oct 29, 2026	With provenance	Details for nextfarm_sdk-0.1.3b24.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for nextfarm-sdk 0.1.3b24
File	Interpreter	ABI	Platform	Actions Reset
nextfarm_sdk-0.1.3b24-py3-none-any.whl 1.6 MB Oct 29, 2026 With provenance	Python 3	none	any	Details for nextfarm_sdk-0.1.3b24-py3-none-any.whl

Total release size: 2.1 MB

Release files / nextfarm_sdk-0.1.3b24.tar.gz

Download URL	nextfarm_sdk-0.1.3b24.tar.gz
Size	561.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`678a24c181312de55e4d37de11a60dd95c90e46f323857934e82977ad22189b9`
BLAKE2b-256 checksum How to use checksums	`ec97999d3260833d133b1bb3aed26baf1adb4bd8507f737490d1d579429b3aea`
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/nextfarm-sdk-python
Publishing commit: github.com/nextx-organization/nextfarm-sdk-python/tree/a5622c2585eb0b996f08312c110626ff2d23fe78

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.3b24.tar.gz
SHA-256 checksum: 678a24c181312de55e4d37de11a60dd95c90e46f323857934e82977ad22189b9 Verifying attestations

Release files / nextfarm_sdk-0.1.3b24-py3-none-any.whl

Download URL	nextfarm_sdk-0.1.3b24-py3-none-any.whl
Size	1.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`d246854387beea7930c5a8ea825d428db1f4d5dd1a825305923cfe100fc3b316`
BLAKE2b-256 checksum How to use checksums	`c55448a7c1e306576dd18f4d2b0da65fabca3c70be386dc1056fdb8af8a63ebb`
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/nextfarm-sdk-python
Publishing commit: github.com/nextx-organization/nextfarm-sdk-python/tree/a5622c2585eb0b996f08312c110626ff2d23fe78

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.3b24-py3-none-any.whl
SHA-256 checksum: d246854387beea7930c5a8ea825d428db1f4d5dd1a825305923cfe100fc3b316 Verifying attestations

Security for nextfarm-sdk 0.1.3b24

Report project as malware

Provenance

Full provenance

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

Attestation for nextfarm_sdk-0.1.3b24.tar.gz

Identity

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

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.3b24.tar.gz
SHA-256 checksum: 678a24c181312de55e4d37de11a60dd95c90e46f323857934e82977ad22189b9 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.