Bắt đầu › Dành cho chủ trại

Nối phần mềm của trại bạn với NextFarm bằng API key

Cho chủ trại, quản lý trại, hoặc người làm hộ một trại (kế toán, đơn vị IT). Không cần tạo app.

① Tạo API key

Trong app NextFarm: Hệ thống › API key → Tạo khoá (chọn scopes, hạn dùng). Key chỉ hiện một lần. Không key nào điều khiển được thiết bị.

Mở app để tạo key
Làm hộ một trại? Sao chép hướng dẫn gửi chủ trại
Nhờ anh/chị tạo API key cho phần mềm của tôi trên NextFarm:
1. Mở app NextFarm › Hệ thống › API key › Tạo khoá.
2. Đặt tên "Phần mềm kế toán", chọn scope chỉ đọc cần dùng (ví dụ: Xem thửa, Xem lô thu hoạch), hạn dùng 1 năm.
3. Bấm Tạo, sao chép key nfk_… (chỉ hiện một lần) và gửi riêng cho tôi.
Key không điều khiển được thiết bị; anh/chị thu hồi lúc nào cũng được ở cùng màn đó.

② Thử key

Key chỉ dùng trong tab này để gọi một lệnh đọc nhẹ.

③ Bạn muốn làm gì?

Đọc thửa & mùa vụ

Cho kế toán / ERP biết thửa, diện tích, cây đang trồng.

Nhận cảnh báo (Webhook)

Cảm biến vượt ngưỡng, thiết bị mất kết nối, lô thu hoạch mới → URL của bạn. Bật ở Hệ thống › Webhook.

Nối n8n / Make

Dùng node HTTP + API key.

Khai lô thu hoạch

Phần mềm kho khai lô, có Idempotency-Key chống trùng.

Cho AI dùng dữ liệu → Nối trợ lý AI (MCP)Làm phần mềm cho nhiều trại → Tạo app

Scopes của API key

Bản đồ & mùa vụ

  • gis.parcels.view Xem thửa và mùa vụ
  • gis.zones.view Xem vùng
  • gis.farmers.view Xem nông dân
  • gis.crop-types.view Xem loại cây trồng
  • gis.facilities.view Xem công trình
  • gis.layers.view Xem lớp bản đồ

IoT (chỉ đọc)

  • iot.devices.view Xem thiết bị
  • iot.telemetry.view Xem số đo cảm biến
  • iot.telemetry.export Xuất số đo cảm biến
  • iot.alerts.view Xem cảnh báo

Thu hoạch & truy xuất

  • harvest.harvest.view Xem lô thu hoạch
  • harvest.harvest.create Tạo lô thu hoạch (ghi)ghi
  • harvest.qr-codes.view Xem tem QR
  • harvest.trace.view Xem truy xuất nguồn gốc
  • harvest.certification.view Xem chứng nhận
  • harvest.market-prices.view Xem giá thị trường

Sổ nông trại & công việc

  • office.base.record.view Xem dữ liệu sổ
  • office.base.record.manage Thêm, sửa dòng sổ (ghi)ghi
  • office.task.view Xem công việc
  • office.calendar.view Xem lịch
  • office.automation.view Xem luật tự động hoá

Báo cáo

  • report.view Xem báo cáo
  • report.export Xuất báo cáo