AGRI_SDK & TELEMETRY_APIS

DEVELOPER DOCUMENTATION

Programmatic interfaces for edge sensor ingestion, drone actuation mesh, and neural agronomy inference engines.

CLIENT_SDK_QUICKSTART

npm install @fhrism/agri-sdkOFFICIAL_RELEASE

import { FhrismClient } from "@fhrism/agri-sdk";

const client = new FhrismClient({
  apiKey: process.env.FHRISM_API_KEY!,
  clusterRegion: "ap-southeast-1",
});

// Stream real-time telemetry from parcel sensor fleet
const subscription = await client.telemetry.subscribe({
  parcelId: "TH-CHIANGMAI-GRID-04",
  metrics: ["soil_moisture_depth_30cm", "evapotranspiration", "nitrogen_ppm"],
  onData: (packet) => {
    console.log("Telemetry received:", packet.timestamp, packet.readings);
  },
});

// TELEMETRY_CORE_API_ENDPOINTS

HTTP REST & gRPC v1

GET/v1/telemetry/parcels/{id}/realtime

AUTH: BEARER_TOKEN

Fetch real-time micro-climate, soil moisture, and atmospheric readings for a defined land parcel.

POST/v1/actuation/irrigation/dispatch

AUTH: HMAC_SECRET

Transmit autonomous pump actuation commands directly to verified field solenoid valves.

GET/v1/models/inference/soil-nitrate

AUTH: BEARER_TOKEN

Execute Prism neural model inference on historic NPK values to calculate 7-day depletion velocity.

GET/v1/trace/batches/{batch_id}/verify

AUTH: PUBLIC_KEY

Cryptographically verify harvest batch Merkle root and GAP certification timestamp.

AUTHENTICATION

Standard bearer tokens generated via operator console. All API traffic enforces TLS 1.3 with optional mutual mTLS on edge relays.

RATE_LIMITS

Default baseline: 10,000 requests per minute per organization token. Burst headroom available up to 2,500 req/sec for SCADA feeds.

WEBHOOKS_AND_EVENTS

Sub-second asynchronous Webhooks for frost warning triggers, soil nitrogen depletion spikes, and drone swarm mission status.

import { FhrismClient } from "@fhrism/agri-sdk"; const client = new FhrismClient({ apiKey: process.env.FHRISM_API_KEY!, clusterRegion: "ap-southeast-1", }); // Stream real-time telemetry from parcel sensor fleet const subscription = await client.telemetry.subscribe({ parcelId: "TH-CHIANGMAI-GRID-04", metrics: ["soil_moisture_depth_30cm", "evapotranspiration", "nitrogen_ppm"], onData: (packet) => { console.log("Telemetry received:", packet.timestamp, packet.readings); }, });