# NextFarm Developers

> Tài liệu nền tảng mở NextFarm (phần mềm nông trại): REST API bằng API key hoặc OAuth app, webhook có signature, máy chủ MCP cho trợ lý AI, SDK Node.js/Python và CLI `nextfarm`. Mọi danh mục sinh từ mã các dịch vụ.

English: every page has an English version under https://developers.nextfarm.vn/en (e.g. https://developers.nextfarm.vn/en/docs/quickstart).

## Bắt đầu
- [Bắt đầu nhanh](https://developers.nextfarm.vn/docs/quickstart): tạo API key, gọi lệnh đầu tiên
- [API key](https://developers.nextfarm.vn/docs/api-keys): scope, cách gửi khoá, error code
- [Ứng dụng & OAuth](https://developers.nextfarm.vn/docs/oauth): app phục vụ nhiều trại, liên kết cài, token
- [Webhooks](https://developers.nextfarm.vn/docs/webhooks): sự kiện, signature, giao lại
- [SDK](https://developers.nextfarm.vn/docs/sdk): thư viện Node.js/TypeScript (npm @nextfarm/sdk) và Python (PyPI nextfarm-sdk) sinh từ OpenAPI, semver · `npm install @nextfarm/sdk` · `pip install nextfarm-sdk`
- [CLI](https://developers.nextfarm.vn/docs/cli): lệnh `nextfarm` v0.3.3 (npm nextfarm): chat với trợ lý nông trại trong terminal, gọi API, API key, webhooks listen, MCP · `brew install nextx-organization/nextfarm/nextfarm` · `npm install -g nextfarm`
- [MCP](https://developers.nextfarm.vn/docs/mcp): nối ChatGPT · Claude · Copilot · Cursor · Gemini · Grok (mọi client MCP) vào dữ liệu trại
- [Môi trường sandbox](https://developers.nextfarm.vn/docs/sandbox) · [Mô hình dữ liệu](https://developers.nextfarm.vn/docs/data-model) · [Phiên bản & ngừng hỗ trợ](https://developers.nextfarm.vn/docs/versioning) · [Nhật ký thay đổi](https://developers.nextfarm.vn/docs/changelog)

## Tham chiếu API
- [Bản đồ & mùa vụ](https://developers.nextfarm.vn/docs/gis): 34 tuyến — Thửa đất, vùng, nông dân, mùa vụ, lớp bản đồ — nền dữ liệu không gian của trang trại.
- [IoT (chỉ đọc)](https://developers.nextfarm.vn/docs/iot): 24 tuyến — Thiết bị, số đo cảm biến, cảnh báo, lịch tưới. API key không có API điều khiển thiết bị.
- [Thu hoạch & truy xuất](https://developers.nextfarm.vn/docs/harvest): 25 tuyến — Bản ghi thu hoạch, cách ly thuốc, lô truy xuất, tem QR, chứng nhận, giá thị trường.
- [Sổ nông trại & công việc](https://developers.nextfarm.vn/docs/office): 57 tuyến — Sổ tự dựng của trại (nhật ký, kho, chi phí…), lịch, luật tự động hoá: đọc bảng, đọc/thêm/sửa dòng.
- [Báo cáo](https://developers.nextfarm.vn/docs/report): 6 tuyến — Báo cáo và chi phí công theo kỳ.

## Tệp máy đọc
- [OpenAPI](https://developers.nextfarm.vn/openapi.json) · [Postman](https://developers.nextfarm.vn/postman.json) · [Toàn văn cho AI](https://developers.nextfarm.vn/llms-full.txt)