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.2b18

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.2b18
File	Size	Uploaded	Provenance	Actions
nextfarm_sdk-0.1.2b18.tar.gz	560.0 kB	Oct 28, 2026	With provenance	Details for nextfarm_sdk-0.1.2b18.tar.gz

Built distribution (wheel)

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

Total release size: 2.1 MB

Release files / nextfarm_sdk-0.1.2b18.tar.gz

Download URL	nextfarm_sdk-0.1.2b18.tar.gz
Size	560.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`13baa4f2fe323966e82155a8628eb5eca5675d1c9c723ed90c6d53b947c69f24`
BLAKE2b-256 checksum How to use checksums	`b85e59cfa9221939d8873d20d5092c689defd7931dece8939f39fbd5d6c491c0`
Upload date	Oct 28, 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/fe30e351d5451409d54b56b256a32da4f26298be

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.2b18.tar.gz
SHA-256 checksum: 13baa4f2fe323966e82155a8628eb5eca5675d1c9c723ed90c6d53b947c69f24 Verifying attestations

Release files / nextfarm_sdk-0.1.2b18-py3-none-any.whl

Download URL	nextfarm_sdk-0.1.2b18-py3-none-any.whl
Size	1.6 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`3d9e21b063b35d54d1cb14331e4975a8c92d0b443c3cfcf127ce8f798a9d28ca`
BLAKE2b-256 checksum How to use checksums	`c09e3da9999fa0784fb87696952162812fc456afd59dea2a0293bdbefd2e32a3`
Upload date	Oct 28, 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/fe30e351d5451409d54b56b256a32da4f26298be

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.2b18-py3-none-any.whl
SHA-256 checksum: 3d9e21b063b35d54d1cb14331e4975a8c92d0b443c3cfcf127ce8f798a9d28ca Verifying attestations

Security for nextfarm-sdk 0.1.2b18

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.2b18.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/fe30e351d5451409d54b56b256a32da4f26298be

Workflow

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

Artifact

Subject: nextfarm_sdk-0.1.2b18.tar.gz
SHA-256 checksum: 13baa4f2fe323966e82155a8628eb5eca5675d1c9c723ed90c6d53b947c69f24 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.