API key và scope

Gửi khoá

Một trong hai header (gateway nhận cả hai):

Authorization: Bearer nfk_...
X-Api-Key: nfk_...

const res = await fetch("https://api-prod.nextfarm.vn/api/v1/iot/devices?status=offline", {
  headers: { Authorization: `Bearer ${process.env.NEXTFARM_API_KEY}` },
});
const { items } = await res.json();

Scope

Giới hạn an toàn

• Khoá chỉ đọc, trừ: tạo/sửa lô thu hoạch, thêm/sửa dòng sổ nông trại. Không xoá được gì.
• Không vào được quản trị người dùng, nhóm quyền, hay tạo khoá khác.
• Thu hồi có hiệu lực ngay; khoá có thể đặt hạn (30 ngày, 90 ngày, 1 năm) hoặc không hết hạn.

n8n / Make

Dùng node HTTP Request (n8n) hoặc HTTP › Make a request (Make): method + URL lấy ở tham chiếu API, header Authorization: Bearer nfk_… (cất key vào Credentials, đừng dán thẳng vào node). Nhận webhook: lấy URL của node Webhook khai ở Hệ thống › Webhook, verify signature bằng node Code.

Method: GET
URL: https://api-prod.nextfarm.vn/api/v1/gis/parcels?page_size=50
Authentication: Generic Credential Type › Header Auth
  Name:  Authorization
  Value: Bearer nfk_…

Error code

Mốc thời gian trả về theo UTC (ISO 8601). Danh sách có pagination qua page, page_size. Thân JSON gửi lên và trả về đều dùng snake_case (vd parcel_id) — khoá camelCase trong thân bị bỏ qua.

Luật bảo mật đầy đủ cho đối tác: Bảo mật →