Skip to main content
This guide shows you how to send a reading to AgriHub360 using curl. You need an AgriHub360 account with a farm. You don’t need hardware yet: send a test reading first, then point a real device at the same endpoint.
1

Get a device id and key

In the app, claim a device on your farm and issue its API key. Copy the device id and the API key.
The key is shown once. Issuing a new key revokes the previous one. You need the Manager role or higher on the farm.
2

Send a reading

Post one reading per request.
The response is the stored row. The server sets timestamp.
3

Check it in the app

Open the device in the app. The reading appears on the device and on every chart, alert rule and model that uses soil moisture for that field.
That’s it. You’ve sent your first reading.

​
What To Know

  • metric_id names what you measured, from the shared catalogue. 220 is soil moisture in percent.
  • The server sets timestamp. Anything you send is ignored.
  • One reading per request, 120 requests per 60 seconds per device key. See Errors and Limits.
  • One key per device. See Authentication.

​
Next Steps

Post a Reading

The endpoint, its fields and every response.

Live Updates

Receive each stored reading over WebSocket.

Bring Your Own Sensor

The contract your sensor has to meet, and two ways to meet it.

Metrics

The catalogue of what a reading can measure.