Tài liệu

Thửa đất, vùng, nông dân, mùa vụ — nền dữ liệu không gian của trang trại.

• GET/api/v1/gis/parcels— Danh sách thửa: mã, diện tích, vùng, cây đang trồng.
• GET/api/v1/gis/parcels/{id}— Chi tiết một thửa: ranh giới, diện tích, chủ, mùa vụ.
• GET/api/v1/gis/seasons— Mùa vụ theo năm: cây, thửa, ngày trồng, dự kiến thu hoạch.
• GET/api/v1/gis/search— Tìm thửa, mùa vụ, nông dân, vùng (phần nào thiếu phạm vi thì rỗng).

Thiết bị, số đo cảm biến, cảnh báo. Không có API điều khiển thiết bị cho khoá API.

• GET/api/v1/iot/devices— Thiết bị và trạng thái kết nối (is_online).
• GET/api/v1/iot/sensor-readings/latest— Số đo mới nhất của cả trại hoặc một vùng.
• GET/api/v1/iot/sensor-readings— Lịch sử số đo theo thiết bị/vùng và khoảng thời gian.
• GET/api/v1/iot/alerts— Cảnh báo cảm biến vượt ngưỡng.
• GET/api/v1/iot/search— Tìm thiết bị theo tên, mã.

Bản ghi thu hoạch, lô truy xuất nguồn gốc, tem QR, chứng nhận VietGAP/GlobalGAP.

• GET/api/v1/farm-harvest/harvest-records— Bản ghi thu hoạch: thửa, cây, sản lượng (kg), trạng thái.
• POST/api/v1/farm-harvest/harvest-records— GHI: khai báo một lô thu hoạch (confirm=true thì xác nhận ngay và phát sự kiện harvest.batch.created).
• GET/api/v1/farm-harvest/trace— Lô truy xuất đã phát hành.
• GET/api/v1/farm-harvest/trace/{id}— Chi tiết lô: nhật ký canh tác, chứng nhận, ảnh.
• GET/api/v1/farm-harvest/certifications/expiring— Chứng nhận sắp hết hạn.
• GET/api/v1/farm-harvest/search— Tìm lô, tem QR, chứng nhận.

Sổ tự dựng của trại (nhật ký, kho, chi phí…): đọc bảng, đọc dòng, thêm dòng.

• GET/api/v1/office/apps/{app_id}/tables— Các bảng trong một sổ và cấu trúc cột.
• POST/api/v1/office/tables/{table_id}/records/list— Đọc dòng của một bảng (POST vì thân chứa bộ lọc).
• POST/api/v1/office/tables/{table_id}/records— GHI: thêm một dòng. data = {id_cột: giá_trị}.