Viết theo CLI bản 0.3.4, ảnh chụp trên Windows PowerShell bản 0.3.3, dữ liệu thật đã được che. Xem đủ cờ lệnh tại developers.nextfarm.vn/docs/cli.
📌 Vị trí: Windows PowerShell → nextfarm keys create, rồi nextfarm ai schedule.
1. Tạo khoá đọc thiết bị IoT
nextfarm keys create --name "Key_IoT_Thực_Địa" --scopes "iot.devices.view" --expires "30d"
PowerShell in dòng Đã tạo khoá, rồi in khoá đúng một lần. Dòng cảnh báo bảo lưu ngay vào nơi an toàn. Chép vào biến secret của máy hoặc của CI. Đừng gửi ảnh này cho người khác. nextfarm keys list không in lại khoá đầy đủ.
2. Đặt lịch 08:00 và xem danh sách
nextfarm ai schedule add "Tóm tắt tình hình sâu bệnh thửa THD00050" --at "08:00"
nextfarm ai schedule list
Lệnh add in Đã lên lịch · hằng ngày 08:00. Mở mục Trợ lý AI trong app NextFarm một lần để cho phép chạy nền. Bảng schedule list có cột ID, Tên, Lịch, Lần tới.
3. Các lệnh khoá khác
nextfarm keys list
nextfarm keys create --name "Đọc lô và thiết bị" --scopes gis.parcels.view,iot.devices.view --expires 90d| Lệnh | Tác dụng | Lưu ý |
|---|---|---|
keys create | Tạo khoá và in khoá đúng một lần. | Chép ngay vào nơi giữ bí mật. --expires nhận 30d, 6m, 1y. Mặc định 90 ngày. --scopes là các mã quyền cách nhau bằng dấu phẩy. |
keys revoke | Ngừng khoá ngay. | Ứng dụng đang gắn khoá này lỗi từ lần gọi sau. |
keys delete | Xoá khoá. | Dùng khi không cần giữ dòng đó trong danh sách. |
keys usage | Số lượt gọi 7 ngày. | Bỏ id để xem theo khoá đang hỏi. |
keys calls | 50 lượt gọi gần nhất của một khoá. | Dùng khi cần biết khoá nào vừa gọi API. |
⚠️ Khoá chỉ in một lần. Chép ngay vào nơi giữ bí mật. Trên PowerShell, truyền khoá bằng biến NEXTFARM_API_KEY cho một lần chạy. Đừng ghi khoá vào file script đem chia sẻ, vào chat, hoặc vào file NEXTFARM.md.Sự kiện webhook
nextfarm webhooks events
nextfarm webhooks events --module gis
nextfarm webhooks schema <tên sự kiện>| Việc | Lệnh | Ghi chú |
|---|---|---|
| Xem endpoint | nextfarm webhooks endpoints list | Các URL workspace đang nhận sự kiện. |
| Thêm endpoint | nextfarm webhooks endpoints create <url> --events <danh sách> | Các sự kiện cách nhau bằng dấu phẩy. |
| Đổi khoá ký | nextfarm webhooks endpoints rotate-secret <id> | Khoá cũ còn hiệu lực một thời gian để bên nhận kịp đổi. |
| Bắn sự kiện mẫu | nextfarm webhooks trigger <event> | Mặc định bắn tới endpoint đầu tiên nhận sự kiện đó. Chỉ định bằng --endpoint. |
| Xem lượt giao | nextfarm webhooks deliveries --status failed | Lọc success, failed, pending. Mặc định 30 dòng. |
| Gửi lại | nextfarm webhooks retry <deliveryId> | Dùng sau khi endpoint đã sửa lỗi. |
| Nghe về máy | nextfarm webhooks listen --forward-to localhost:3000/hook | Sự kiện thật được chuyển tới máy đang phát triển. --events để chỉ nghe một vài sự kiện. |
| Kiểm chữ ký | nextfarm webhooks verify | Chạy tại máy, không gọi máy chủ NextFarm. Cần secret, payload và header đã nhận. |
💡nextfarm webhooks listen --print-jsonin thân sự kiện ra PowerShell. Chỉ thêm--print-secretkhi đang sửa chữ ký, và đừng để secret nằm trong log chia sẻ.